ScyllaDB Cloud MCP Server BETA

ScyllaDB Cloud MCP Server BETA¶

Note

ScyllaDB Cloud MCP is currently in Beta. It offers read-only tools to help you get information about your clusters and account. Additional tools will be added in upcoming releases.

Overview¶

Model Context Protocol (MCP) is an open standard for connecting AI agents to external tools and data sources.

The ScyllaDB Cloud MCP server implements this standard, exposing the ScyllaDB Cloud API as tools that AI agents can discover and call directly.

It can be used with any AI client that supports MCP. For example:

For a ready-to-use agent setup, see the ScyllaDB agent skills repository.

ScyllaDB MCP Tools¶

The following tools are available in the current Beta release. They are all read-only, providing a safe way to query information about your ScyllaDB Cloud environment:

Tool	Description
`get_account_info`	Get account details and associated cloud accounts.
`list_clusters`	List all clusters with optional metrics.
`get_cluster_overview`	Get cluster details, data centers, and nodes in a single call.
`get_cluster_health`	Get node health, data center metrics, and cluster-level metrics.
`get_documentation`	Browse API documentation, models, and product documentation.

More tools will be added in upcoming releases, including tools for creating and monitoring clusters and updating scaling policies.

Connecting to the MCP Server¶

Prerequisites¶

Before connecting, make sure you have the following:

A ScyllaDB Cloud cluster
An MCP-compatible client
Node.js

Configure the MCP Connection¶

To connect to the ScyllaDB Cloud MCP server you need:

MCP Server URL: https://api.cloud.scylladb.com/mcp
Access Token: A personal API token. See Create a Personal Token for Authentication for instructions.

The following example shows how to configure the connection in OpenCode. For other MCP clients, refer to their documentation.

Sign in to ScyllaDB Cloud and create a personal access token.
Open the OpenCode configuration file opencode.jsonc.

Add the MCP connection under the mcp key. Provide the ScyllaDB Cloud MCP server URL and set the Authorization header to your personal token, prefixed with the Bearer identifier:

"mcp": {
  "scylladb-cloud": {
    "type": "remote",
    "url": "https://api.cloud.scylladb.com/mcp",
    "headers": {
      "Authorization": "Bearer <PERSONAL_API_TOKEN>"
    },
    "timeout": 30000
  }
}

Replace <PERSONAL_API_TOKEN> with the token you generated in step 1.

Once you are connected to the MCP server, you can list its tools, run them, and inspect their responses.

Example of listing and running MCP tools in an AI client

Was this page helpful?