Skip to main content
Glama
oracle-cloud-mcp

oracle-cloud-mcp

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

oci_compute_list_instances

List all VM instances in a compartment

oci_compute_get_instance

Get detailed info for a specific instance

oci_compute_list_shapes

List available shapes (including Always Free)

oci_compute_instance_action

START, STOP, RESET, SOFTSTOP, or SOFTRESET an instance

Object Storage (5 tools)

Tool

Description

oci_os_get_namespace

Get the Object Storage namespace

oci_os_list_buckets

List all buckets in a compartment

oci_os_create_bucket

Create a new bucket (Standard or Archive)

oci_os_list_objects

List objects with optional prefix filter

oci_os_delete_bucket

Delete an empty bucket

Block Storage (2 tools)

Tool

Description

oci_bv_list_volumes

List block volumes

oci_bv_list_boot_volumes

List boot volumes in an availability domain

Networking (3 tools)

Tool

Description

oci_vcn_list

List Virtual Cloud Networks

oci_subnet_list

List subnets in a VCN

oci_vcn_create

Create a new VCN with CIDR blocks

Autonomous Database (4 tools)

Tool

Description

oci_adb_list

List Autonomous Databases (ATP/ADW)

oci_adb_get

Get database details and connection strings

oci_adb_start

Start a stopped database

oci_adb_stop

Stop a running database

IAM (5 tools)

Tool

Description

oci_iam_list_users

List IAM users

oci_iam_list_groups

List IAM groups

oci_iam_list_policies

List IAM policies and statements

oci_iam_list_compartments

List compartments in the tenancy

oci_iam_list_availability_domains

List availability domains

Related MCP server: OCI MCP Server

Install

npm install

Configuration

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.pem

Add 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

OCI_CONFIG_FILE

Path to OCI config file

No (defaults to ~/.oci/config)

OCI_PROFILE

Config profile name

No (defaults to DEFAULT)

OCI_TENANCY_OCID

Tenancy OCID

No (read from config)

OCI_REGION

OCI region

No (defaults to us-chicago-1)

Authentication

Supports two methods:

  1. Session Token -- uses security_token_file from config (recommended for interactive use)

  2. 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 SDK

  • oci-sdk -- Official Oracle Cloud SDK for Node.js

License

MIT

Available Tools

23 tools
oci_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

    A3.5/5.0

    Scored across 23 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Model Context Protocol (MCP) server exposing Oracle Cloud Infrastructure tools, resources and prompts.
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      An 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.
      55
      1
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP 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
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables 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.
      -