OCI OpenSearch MCP Server
Overview
This server provides MCP tools for interacting with the Oracle Cloud Infrastructure (OCI) OpenSearch control plane.
It exposes a focused, SDK-backed set of OpenSearch cluster lifecycle operations and work-request tracking tools for use by MCP clients.
Authentication
The server uses standard OCI configuration and signer behavior. Configure OCI credentials with an OCI config file and profile before starting the server. The active OCI identity's IAM permissions determine which OpenSearch operations are allowed.
Running the server
STDIO transport mode
uvx oracle.oci-opensearch-mcp-server
Local development from source
From this project directory, use one of these commands:
uv run oracle.oci-opensearch-mcp-server
uvx --from . oracle.oci-opensearch-mcp-server
Tools
| Tool Name | Description |
|---|---|
list_opensearch_clusters |
List OpenSearch clusters in a compartment |
get_opensearch_cluster |
Get a cluster by OCID |
list_opensearch_cluster_shapes |
List available OpenSearch cluster node shapes |
create_opensearch_cluster |
Create a cluster |
update_opensearch_cluster |
Update a cluster |
delete_opensearch_cluster |
Delete a cluster |
resize_opensearch_cluster_vertical |
Resize a cluster vertically |
resize_opensearch_cluster_horizontal |
Resize a cluster horizontally |
backup_opensearch_cluster |
Trigger a cluster backup |
list_work_requests |
List work requests; returns items and count |
get_work_request |
Get work request status |
Resources
| Resource | Description |
|---|---|
resource://oci-opensearch-api-guide |
MVP guidance for async OpenSearch cluster workflows |
resource://oci-opensearch-work-request-guide |
Guidance for work-request status tracking and failure triage |
resource://oci-opensearch-tool-surface-summary |
Summary of implemented MVP tools and deferred families |
Request body guidance
Mutation tools use OCI Python SDK-style request bodies with snake_case field names.
For detailed payload conventions and examples, read the bundled
resource://oci-opensearch-api-guide resource from your MCP client.
update_opensearch_cluster accepts a non-empty partial update_details body.
display_name is optional and only needed when renaming a cluster.
To discover existing clusters, use list_opensearch_clusters rather than create_opensearch_cluster.
Most mutating operations are asynchronous and return an opc_work_request_id. Use
get_work_request and list_work_requests to inspect status. MCP agents should not
poll continuously by default: after an async response, they may call get_work_request
once for an immediate status snapshot, then ask the user before repeated checks.
For create, resize, and backup operations, MCP sends an opc_retry_token; callers may
provide one explicitly, otherwise MCP generates and returns a deterministic token for the
same logical request.
An empty list_work_requests match is explicit: {"items": [], "count": 0}.
Notes
⚠️ NOTE: All actions are performed with the permissions of the configured OCI profile. Use least-privilege IAM policies, secure credential handling, and safe operational practices.
Third-Party APIs
Developers choosing to distribute a binary implementation of this project are responsible for obtaining and providing all required licenses and copyright notices for third-party code.
Disclaimer
Users are responsible for their local environment and credential safety. Different language model selections may yield different results and performance.
License
Copyright (c) 2026 Oracle and/or its affiliates.
Released under the Universal Permissive License v1.0 as shown at https://oss.oracle.com/licenses/upl/.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file oracle_oci_opensearch_mcp_server-1.0.1.tar.gz.
File metadata
- Download URL: oracle_oci_opensearch_mcp_server-1.0.1.tar.gz
- Upload date:
- Size: 86.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Oracle Linux Server","version":"9.8","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8e463b2e98b02fd29dfabec00b79f12b34e15bda02f40f13da1c331ced631976
|
|
| MD5 |
0363041f4023f7782b4a1fc8cf3906a6
|
|
| BLAKE2b-256 |
c0b8a0819d7410f83d740135f80c99938ae0f2b4023a3e4e1e7fb17b4b60ae9f
|
File details
Details for the file oracle_oci_opensearch_mcp_server-1.0.1-py3-none-any.whl.
File metadata
- Download URL: oracle_oci_opensearch_mcp_server-1.0.1-py3-none-any.whl
- Upload date:
- Size: 23.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Oracle Linux Server","version":"9.8","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
137c66bcb6dd0eabe2e98f77397938903a8c43dbc51821badf0bf3ee2add4fea
|
|
| MD5 |
0c941d18479d04b4621d71b8b18a5129
|
|
| BLAKE2b-256 |
4b0a7473a58b0f8d5ca8521c021bfb7bfd58dfc8a1ca9f215747698d22fda1c7
|
