oracle-cloud-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@oracle-cloud-mcp list instances in compartment production"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
oracle-cloud-mcp
[!License: MIT](https://opensource.org/licenses/MIT) [!MCP](https://modelcontextprotocol.io) [!Node.js](https://nodejs.org)
MCP server for Oracle Cloud Infrastructure (OCI). Provides access to Compute, Object Storage, Block Storage, Networking, Autonomous Database, and IAM via the official OCI SDK.
Tools (23 total)
Compute (4 tools)
Tool | Description |
| List all VM instances in a compartment |
| Get detailed info for a specific instance |
| List available shapes (including Always Free) |
| START, STOP, RESET, SOFTSTOP, or SOFTRESET an instance |
Object Storage (5 tools)
Tool | Description |
| Get the Object Storage namespace |
| List all buckets in a compartment |
| Create a new bucket (Standard or Archive) |
| List objects with optional prefix filter |
| Delete an empty bucket |
Block Storage (2 tools)
Tool | Description |
| List block volumes |
| List boot volumes in an availability domain |
Networking (3 tools)
Tool | Description |
| List Virtual Cloud Networks |
| List subnets in a VCN |
| Create a new VCN with CIDR blocks |
Autonomous Database (4 tools)
Tool | Description |
| List Autonomous Databases (ATP/ADW) |
| Get database details and connection strings |
| Start a stopped database |
| Stop a running database |
IAM (5 tools)
Tool | Description |
| List IAM users |
| List IAM groups |
| List IAM policies and statements |
| List compartments in the tenancy |
| List availability domains |
Related MCP server: OCI MCP Server
Install
npm installConfiguration
Configure OCI credentials in ~/.oci/config:
[DEFAULT]
user=ocid1.user.oc1..xxx
fingerprint=xx:xx:xx:xx:xx
tenancy=ocid1.tenancy.oc1..xxx
region=us-chicago-1
key_file=~/.oci/api_keys/oci_api_key.pemAdd to your Claude Code MCP config:
{
"mcpServers": {
"oracle": {
"type": "stdio",
"command": "node",
"args": ["/path/to/oracle-mcp/index.js"],
"env": {
"OCI_CONFIG_FILE": "~/.oci/config",
"OCI_PROFILE": "DEFAULT",
"OCI_REGION": "us-chicago-1"
}
}
}
}Environment Variables
Variable | Description | Required |
| Path to OCI config file | No (defaults to ~/.oci/config) |
| Config profile name | No (defaults to DEFAULT) |
| Tenancy OCID | No (read from config) |
| OCI region | No (defaults to us-chicago-1) |
Authentication
Supports two methods:
Session Token -- uses
security_token_filefrom config (recommended for interactive use)API Key -- uses RSA key pair with fingerprint (for automation)
Oracle Cloud Free Tier
Resource | Free Allocation |
Compute (Ampere A1) | 4 OCPUs, 24 GB RAM |
Compute (AMD E2.1.Micro) | 2 instances |
Object Storage | 20 GB Standard + 20 GB Archive |
Block Storage | 200 GB total |
Autonomous Database | 2 Always Free databases |
Outbound Data | 10 TB/month |
Dependencies
@modelcontextprotocol/sdk-- MCP protocol SDKoci-sdk-- Official Oracle Cloud SDK for Node.js
License
Available Tools
23 toolsoci_adb_getA
Get detailed information about an Autonomous Database
Inputs: database_id (required).
oci_adb_listA
List Autonomous Databases (ATP/ADW). Free Tier includes 2 Always Free ATP or ADW databases.
Inputs: limit, compartment_id.
oci_adb_startB
Start a stopped Autonomous Database
Inputs: database_id (required).
oci_adb_stopA
Stop a running Autonomous Database
Inputs: database_id (required).
oci_bv_list_boot_volumesC
List boot volumes in an availability domain
Inputs: limit, compartment_id, availability_domain.
oci_bv_list_volumesA
List block volumes in a compartment (Free Tier: 200GB total)
Inputs: limit, compartment_id.
oci_compute_get_instanceA
Get detailed information about a specific compute instance
Inputs: instance_id (required).
oci_compute_instance_actionA
Perform action on a compute instance (START, STOP, RESET, SOFTSTOP, SOFTRESET)
Inputs: action (required), instance_id (required).
oci_compute_list_instancesA
List all compute instances in a compartment. Shows VM details including shape, state, and availability domain.
Inputs: limit, compartment_id.
oci_compute_list_shapesA
List available compute shapes including Always Free shapes (VM.Standard.A1.Flex, VM.Standard.E2.1.Micro)
Inputs: limit, compartment_id.
oci_iam_list_availability_domainsB
List availability domains in the region
Inputs: compartment_id.
oci_iam_list_compartmentsA
List compartments in the tenancy hierarchy
Inputs: limit, compartment_id.
oci_iam_list_groupsB
List IAM groups in the tenancy
Inputs: limit, compartment_id.
oci_iam_list_policiesB
List IAM policies in a compartment
Inputs: limit, compartment_id.
oci_iam_list_usersB
List IAM users in the tenancy
Inputs: limit, compartment_id.
oci_os_create_bucketB
Create a new Object Storage bucket
Inputs: bucket_name (required), storage_tier, public_access, compartment_id.
oci_os_delete_bucketA
Delete an empty Object Storage bucket
Inputs: bucket_name (required), compartment_id.
oci_os_get_namespaceA
Get the Object Storage namespace for the tenancy
Inputs: compartment_id.
oci_os_list_bucketsB
List all Object Storage buckets in a compartment (Free Tier: 20GB standard, 20GB archive)
Inputs: limit, compartment_id.
oci_os_list_objectsA
List objects in a bucket with optional prefix filter
Inputs: bucket_name (required), limit, prefix, compartment_id.
oci_subnet_listB
List subnets in a VCN
Inputs: vcn_id (required), limit, compartment_id.
oci_vcn_createB
Create a new Virtual Cloud Network
Inputs: display_name (required), dns_label, cidr_blocks, compartment_id.
oci_vcn_listA
List Virtual Cloud Networks (VCNs) in a compartment
Inputs: limit, compartment_id.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 23 tools
Each tool is clearly scoped to a specific Oracle Cloud service and resource, with distinct actions. The service prefixes (compute, os, bv, vcn, adb, iam) prevent cross-service confusion, and within each service, tools like list, get, create, and start/stop are unambiguous.
Most tools follow the oci_<service>_<verb>_<noun> pattern (e.g., oci_compute_list_instances, oci_os_create_bucket). A few deviations exist, such as oci_vcn_list and oci_subnet_list omitting the resource noun, and oci_compute_instance_action using a different structure, but the overall pattern is readable and predictable.
With 23 tools spanning compute, storage, networking, database, and IAM, the count is reasonable for a cloud provider server. It covers multiple services without being excessively large, though it is slightly heavier than the ideal 3-15 range.
The set is heavily read-focused, providing list and get operations for most services, plus some actions like start/stop and bucket creation. However, it lacks core lifecycle operations such as compute instance creation/termination, object upload/download, and VCN deletion, leaving notable gaps for full management workflows.
Maintenance
Related MCP Connectors
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
MCP server for interacting with the Supabase platform
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceModel Context Protocol (MCP) server exposing Oracle Cloud Infrastructure tools, resources and prompts.MIT
- AlicenseCqualityDmaintenanceAn MCP server that exposes Oracle Cloud Infrastructure (OCI) control plane to LLM clients, enabling management of compute, networking, storage, databases, and more through natural language.551Apache 2.0
- AlicenseNot gradedqualityDmaintenanceMCP server for Oracle Container Engine for Kubernetes (OKE) that enables inspection, querying, and troubleshooting of OKE clusters through safe, composable tools.Universal Permissive v1.0
- FlicenseNot gradedqualityBmaintenanceEnables interaction with Oracle Cloud Infrastructure through the MCP protocol. Supports dynamic profile selection and provides 85 tools for managing compute, databases, networking, IAM, storage, load balancers, OKE, monitoring, and cost management.-