Connect Oracle Cloud Infrastructure to Your AI Agent

Ask AI to inventory a compartment or analyze metrics for an instance before deciding on a change.

34 tools Custom credential

Connect Oracle Cloud Infrastructure Install OOMOL

Try a Oracle Cloud Infrastructure Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Oracle Cloud Infrastructure

Inventory compartment resources

Read instances and their network connections for an infrastructure overview.

/oo Oracle Cloud Infrastructure: In OCI compartment [OCID], list compute instances and VNIC attachments. Read the relevant VNICs and summarize instance states, shapes, and assigned IP addresses.

Analyze instance metric data

Discover available metrics and query the period relevant to your performance question.

/oo Oracle Cloud Infrastructure: List OCI metrics in compartment [OCID] for namespace [namespace]. Run MQL [expression] from [start date and time] to [end date and time], and summarize the metric trend and gaps.

Start Working with Oracle Cloud Infrastructure

Install OOMOL

Set up oo CLI and the oo Skill in your agent.
Install OOMOL →
Connect Oracle Cloud Infrastructure

Connect your tenancy and user OCIDs, API key fingerprint, paired PEM signing private key, region, and default compartment OCID. Supply the passphrase if the key is encrypted.
Connect Oracle Cloud Infrastructure →
Give Your Agent a Task

Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →

Choose Your Agent

Codex Claude Code Cursor Hermes

An OCI IAM user with an API signing key and policies permitting the requested resources.
The target OCI region and default compartment; realm can be specified when needed.
Resizing may restart an instance. Termination permanently removes it.

Oracle Cloud Infrastructure Tools

The integration reads OCI compute, networking, identity, and monitoring data. It also launches and manages instances, creates networks and subnets, and runs scripts through Oracle Cloud Agent.

Compute and host commands

Inspect images and instances, launch or resize instances, perform lifecycle actions, and run agent scripts.

Virtual networking

Inspect VCNs, subnets, interfaces, and security groups, or create VCNs and subnets.

Identity and monitoring

Inspect tenancy and compartment information, alarms, metric definitions, and aggregated metrics.

34 tools

List Instances

List OCI compute instances in a compartment.

oracle_cloud.list_instances

Get Instance

Get a compute instance by OCID.

oracle_cloud.get_instance

Launch Instance

Launch a compute instance from an image in a subnet.

oracle_cloud.launch_instance

Terminate Instance

Permanently terminate a compute instance. This destructive operation cannot be undone.

oracle_cloud.terminate_instance

Update Instance

Update flexible shape resources for an instance; OCI may restart the instance.

oracle_cloud.update_instance

List Images

List compute images, optionally filtered by operating system.

oracle_cloud.list_images

Get Image

Get a compute image by OCID.

oracle_cloud.get_image

Instance Action

Perform one of the instance actions exposed by Oracle's official Compute MCP server.

oracle_cloud.instance_action

List Vnic Attachments

List VNIC attachments in a compartment, optionally for one instance.

oracle_cloud.list_vnic_attachments

Get Vnic Attachment

Get a VNIC attachment by OCID.

oracle_cloud.get_vnic_attachment

List Vcns

List virtual cloud networks in a compartment.

oracle_cloud.list_vcns

Get Vcn

Get a virtual cloud network by OCID.

oracle_cloud.get_vcn

Delete Vcn

Permanently delete an empty VCN. This is destructive.

oracle_cloud.delete_vcn

Create Vcn

Create a virtual cloud network.

oracle_cloud.create_vcn

List Subnets

List subnets in a compartment, optionally filtered by VCN.

oracle_cloud.list_subnets

Get Subnet

Get a subnet by OCID.

oracle_cloud.get_subnet

Create Subnet

Create a subnet in a VCN.

oracle_cloud.create_subnet

List Security Lists

List security lists in a compartment, optionally filtered by VCN.

oracle_cloud.list_security_lists

Get Security List

Get a security list by OCID.

oracle_cloud.get_security_list

List Network Security Groups

List network security groups, optionally filtered by VCN or VLAN.

oracle_cloud.list_network_security_groups

Get Network Security Group

Get a network security group by OCID.

oracle_cloud.get_network_security_group

Get Vnic

Get a VNIC and its assigned IP addresses by OCID.

oracle_cloud.get_vnic

List Alarms

List Monitoring alarms in a compartment.

oracle_cloud.list_alarms

List Metric Definitions

List available OCI Monitoring metric definitions.

oracle_cloud.list_metric_definitions

Get Metrics Data

Retrieve aggregated OCI Monitoring metric data using an MQL expression.

oracle_cloud.get_metrics_data

List Compartments

List child compartments, optionally traversing the tenancy subtree.

oracle_cloud.list_compartments

Get Tenancy

Get a tenancy by OCID.

oracle_cloud.get_tenancy

List Availability Domains

List availability domains accessible from a compartment or tenancy.

oracle_cloud.list_availability_domains

Get Current Tenancy

Get the tenancy configured on this connection.

oracle_cloud.get_current_tenancy

Get Current User

Get the IAM user configured on this connection.

oracle_cloud.get_current_user

Get Compartment By Name

Find a direct child compartment by exact name.

oracle_cloud.get_compartment_by_name

List Subscribed Regions

List regions to which a tenancy is subscribed.

oracle_cloud.list_subscribed_regions

Run Instance Agent Command

Run a shell or batch script through Oracle Cloud Agent. The script executes on the target host with the agent service account's privileges.

oracle_cloud.run_instance_agent_command

List Instance Agent Command Executions

List Oracle Cloud Agent command executions for a compute instance.

oracle_cloud.list_instance_agent_command_executions

Frequently Asked Questions

How do I choose the resource scope?

Supply a compartment OCID or use the default stored on the connection. Requests use the configured region, and OCI IAM policies determine access.

What is needed to query metrics?

Specify the namespace and MQL expression. Include a date-time range, or the query defaults to the last three hours.

What happens when I run an agent command?

The script executes on the target instance with the agent service account’s privileges. The connector waits up to four minutes; a timeout does not establish that the script stopped.