# Oracle Cloud

> Oracle Cloud is an open-source MCP server for cloud and infrastructure. MCP server giving AI clients tools to manage Oracle Cloud Infrastructure resources. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/expertvagabond/oracle-cloud-mcp
- **MCP Registry name:** io.github.ExpertVagabond/oracle-cloud
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure)
- **Listing updated:** 2026-11-18

## About

The README describes this as an MCP server that wraps the official Oracle Cloud Infrastructure SDK, exposing 23 tools across compute, object storage, block storage, networking, Autonomous Database and IAM. An assistant connected to it can list and inspect VM instances, start or stop them, manage buckets and objects, look at VCNs and subnets, and start or stop Autonomous Databases.

Authentication reuses a standard OCI config file, supporting either a session token or an API key pair. Environment variables select the profile, region and config path. The README also includes a table of Oracle Cloud Free Tier allocations as context for which resources are available at no cost.

The server is aimed at developers and operators who already use Oracle Cloud and want to query or control their infrastructure from an AI client such as Claude Code, rather than through the console or CLI. It is published on npm and released under the MIT licence.

## Features

- **Compute instance control:** Lists instances and shapes, retrieves instance details, and runs start, stop, reset and soft-restart actions.
- **Object and block storage tools:** Lists, creates and deletes buckets, lists objects by prefix, and lists block and boot volumes.
- **Networking inspection:** Lists and creates Virtual Cloud Networks and lists subnets within a VCN.
- **Autonomous Database management:** Lists ATP and ADW databases, shows connection strings, and starts or stops them.
- **IAM visibility:** Lists users, groups, policies, compartments and availability domains in a tenancy.
- **Flexible credentials:** Works with a session token or an API key from the standard OCI config file, with profile and region overrides.

## Good for

- Checking which compute instances are running in a compartment from an AI chat
- Starting or stopping VM instances and Autonomous Databases on a schedule or on request
- Auditing IAM users, groups and policies across a tenancy
- Creating a VCN and subnets while planning network layout
- Reviewing storage buckets and block volumes during cost or cleanup work

## Install

### Claude Code (Terminal)

```sh
claude mcp add oracle-cloud -- npx -y oracle-cloud-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "oracle-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "oracle-cloud-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "oracle-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "oracle-cloud-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "oracle-cloud": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "oracle-cloud-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "oracle-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "oracle-cloud-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "oracle-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "oracle-cloud-mcp"
      ]
    }
  }
}
```

## Tools

- `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
- `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
- `oci_bv_list_volumes`: List block volumes
- `oci_bv_list_boot_volumes`: List boot volumes in an availability domain
- `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
- `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
- `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

## FAQ

### How does the server authenticate to Oracle Cloud?

The README says it uses a session token from the config file (recommended for interactive use) or an API key with an RSA key pair and fingerprint (for automation).

### How is it installed?

The README lists npm install for the package oracle-cloud-mcp, and the registry entry shows it runs over stdio.

### Which Oracle Cloud services are covered?

Compute, Object Storage, Block Storage, Networking, Autonomous Database and IAM, with 23 tools in total.

### Is Oracle Cloud free?

Yes. Oracle Cloud is open source, so you can use and self-host it for free.

### How do I add Oracle Cloud to Claude Code?

Run this command in your terminal: claude mcp add oracle-cloud -- npx -y oracle-cloud-mcp

### What are the best alternatives to Oracle Cloud?

The closest alternatives to Oracle Cloud are Ibmcloud, Civo MCP by usefulapi, mcp, UpCloud MCP by usefulapi and Exoscale MCP by usefulapi.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Ibmcloud](https://ai-powered.com/mcp/ibmcloud): Ibmcloud is an open-source MCP server for cloud and infrastructure.
- [Civo MCP by usefulapi](https://ai-powered.com/mcp/civo-mcp-by-usefulapi): Civo MCP by usefulapi is a freemium MCP server for cloud and infrastructure.
- [mcp](https://ai-powered.com/mcp/mcp-mwfu4c84): mcp is an open-source MCP server for cloud and infrastructure.
- [UpCloud MCP by usefulapi](https://ai-powered.com/mcp/upcloud-mcp-by-usefulapi): UpCloud MCP by usefulapi is a freemium MCP server for cloud and infrastructure.
- [Exoscale MCP by usefulapi](https://ai-powered.com/mcp/exoscale-mcp-by-usefulapi): Exoscale MCP by usefulapi is a freemium MCP server for cloud and infrastructure.
- [RunCloud MCP by usefulapi](https://ai-powered.com/mcp/runcloud-mcp-by-usefulapi): RunCloud MCP by usefulapi is a freemium MCP server for cloud and infrastructure.
- [Hetzner Cloud MCP by usefulapi](https://ai-powered.com/mcp/hetzner-cloud-mcp-by-usefulapi): Hetzner Cloud MCP by usefulapi is a freemium MCP server for cloud and infrastructure.
- [Komodo MCP Server](https://ai-powered.com/mcp/komodo-mcp-server-2): Komodo MCP Server is an open-source MCP server for cloud and infrastructure.

---
Source: https://ai-powered.com/mcp/oracle-cloud
