> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Chainstack MCP server

> Chainstack MCP server for AI agents — deploy blockchain nodes, search docs, request testnet faucet tokens, fetch pricing, and contact the team.

## Quick start

Type or paste this into any AI agent:

```
get mcp.chainstack.com
```

The agent will fetch the onboarding page, understand what the server offers, and walk you through setup. That's it.

***

The **Chainstack MCP server** gives AI agents direct access to the Chainstack platform — deploy blockchain nodes, search documentation, request testnet faucet tokens, fetch live pricing, contact the Chainstack team, and check platform status, all from your coding environment. It works with Claude Code, Cursor, Codex, Windsurf, Gemini CLI, GitHub Copilot, Antigravity, Claude.ai, and ChatGPT.

[MCP (Model Context Protocol)](https://modelcontextprotocol.io/) is an open standard that lets AI applications connect to external tools and data sources. The Chainstack MCP server is a remote Streamable HTTP server — no local setup required.

## Tools

**No API key needed:**

| Tool                     | Description                                                                                            |
| ------------------------ | ------------------------------------------------------------------------------------------------------ |
| `search_docs`            | Search Chainstack documentation — blockchain RPC methods, deployment guides, code examples             |
| `get_doc_page`           | Fetch the full content of a documentation page                                                         |
| `get_platform_status`    | Check platform status, active incidents, and network health                                            |
| `contact_chainstack`     | Submit a message to the Chainstack team — sales, support, or general inquiries                         |
| `get_chainstack_pricing` | Fetch a live Chainstack pricing snapshot — plan tiers, feature matrix, add-ons, dedicated-node catalog |

**API key required** (get one at [console.chainstack.com/user/settings/api-keys](https://console.chainstack.com/user/settings/api-keys)). All tools appear in the agent's tool list regardless of auth — the tools below execute only when the key is configured. Calls without it return an auth error.

| Tool                     | Description                                                                                                                                     |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_organization`       | Get organization name and ID                                                                                                                    |
| `get_deployment_options` | List available blockchain/cloud/region combinations                                                                                             |
| `list_projects`          | List all projects                                                                                                                               |
| `create_project`         | Create a new project                                                                                                                            |
| `get_project`            | Get project details                                                                                                                             |
| `update_project`         | Update a project's name or description                                                                                                          |
| `delete_project`         | Delete a project                                                                                                                                |
| `list_nodes`             | List all nodes with status and endpoints                                                                                                        |
| `get_node`               | Get a node's full details including RPC endpoints                                                                                               |
| `create_node`            | Deploy a new blockchain node                                                                                                                    |
| `update_node`            | Rename a node                                                                                                                                   |
| `delete_node`            | Delete a node                                                                                                                                   |
| `request_testnet_funds`  | Top up a testnet address from the [Chainstack faucet](/docs/faucets) — Sepolia, Hoodi, Base Sepolia, Amoy, BNB testnet, Solana devnet, and more |

## Option 1: Install as a skill

Save the SKILL.md to your agent's skills directory. The agent calls tools via HTTP on demand — no MCP registration, no tools forced into context.

| Agent                                      | Skills directory                         |
| ------------------------------------------ | ---------------------------------------- |
| Claude Code / Cowork                       | `~/.claude/skills/chainstack/`           |
| Codex / Gemini CLI / Antigravity / Copilot | `~/.agents/skills/chainstack/`           |
| Cursor                                     | `~/.cursor/skills/chainstack/`           |
| Windsurf                                   | `~/.codeium/windsurf/skills/chainstack/` |

```bash theme={"system"}
# Claude Code
mkdir -p ~/.claude/skills/chainstack
curl -o ~/.claude/skills/chainstack/SKILL.md https://mcp.chainstack.com/skill

# Codex, Gemini CLI, Antigravity, Copilot (shared directory)
mkdir -p ~/.agents/skills/chainstack
curl -o ~/.agents/skills/chainstack/SKILL.md https://mcp.chainstack.com/skill
```

You may need to restart your agent or start a new session for the skill to take effect.

The skill contains workflows, tool reference, curl examples, and error handling. To set up your API key for authenticated tools, add it to your shell profile:

```bash theme={"system"}
export CHAINSTACK_API_KEY="your-key-from-console.chainstack.com/user/settings/api-keys"
```

## Option 2: Register as an MCP server

Add the server to your agent's configuration. Tools appear in context every session.

### Claude Code

```bash theme={"system"}
# All projects
claude mcp add --transport http chainstack https://mcp.chainstack.com/mcp -s user

# This project only
claude mcp add --transport http chainstack https://mcp.chainstack.com/mcp

# With API key
claude mcp add --transport http chainstack https://mcp.chainstack.com/mcp -s user \
  --header "Authorization: Bearer YOUR_API_KEY"
```

### Codex CLI

```bash theme={"system"}
codex mcp add chainstack --url https://mcp.chainstack.com/mcp
```

Or edit `~/.codex/config.toml`:

```toml theme={"system"}
[mcp_servers.chainstack]
url = "https://mcp.chainstack.com/mcp"

[mcp_servers.chainstack.http_headers]
Authorization = "Bearer YOUR_API_KEY"
```

### Cursor

Edit `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project):

```json theme={"system"}
{
  "mcpServers": {
    "chainstack": {
      "url": "https://mcp.chainstack.com/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

### Windsurf

Edit `~/.codeium/windsurf/mcp_config.json`:

```json theme={"system"}
{
  "mcpServers": {
    "chainstack": {
      "serverUrl": "https://mcp.chainstack.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

### VS Code

Chainstack is listed in the GitHub MCP Registry, so VS Code can install it for you. There are two ways to do it.

**From inside VS Code** — open the Extensions view (**⇧⌘X** on macOS, **Ctrl+Shift+X** on Windows and Linux), search `@mcp chainstack`, and click **Install** on the Chainstack entry. To install into the workspace rather than your user profile, right-click the entry and select **Install in Workspace**, which writes `.vscode/mcp.json`.

**From the registry in your browser** — open the [Chainstack entry in the GitHub MCP Registry](https://github.com/mcp/com.chainstack/chainstack) and click **Install** > **Install in VS Code**. VS Code opens and asks you to confirm.

Both paths add the server without an API key, which covers every tool that works unauthenticated. To add your key, or to configure by hand, edit `.vscode/mcp.json` (workspace) or run **MCP: Open User Configuration** from the Command Palette (global):

```json theme={"system"}
{
  "servers": {
    "chainstack": {
      "type": "http",
      "url": "https://mcp.chainstack.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

<Note>
  VS Code uses `servers` as the root key, not `mcpServers`.
</Note>

Installed servers appear under **MCP SERVERS - INSTALLED** in the Extensions view, and **MCP: List Servers** in the Command Palette enables, disables, and shows logs for them. To use the tools, open the Chat view in agent mode and click **Configure Tools** to toggle the Chainstack tools on.

### Gemini CLI

```bash theme={"system"}
# All projects
gemini mcp add -s user --url https://mcp.chainstack.com/mcp chainstack

# This project only
gemini mcp add --url https://mcp.chainstack.com/mcp chainstack
```

Or edit `~/.gemini/settings.json` (global) or `.gemini/settings.json` (project):

```json theme={"system"}
{
  "mcpServers": {
    "chainstack": {
      "httpUrl": "https://mcp.chainstack.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

<Note>
  Gemini CLI uses `httpUrl` for Streamable HTTP endpoints, not `url`.
</Note>

### Antigravity

Edit `~/.gemini/antigravity/mcp_config.json`:

```json theme={"system"}
{
  "mcpServers": {
    "chainstack": {
      "serverUrl": "https://mcp.chainstack.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

### Claude.ai

Settings > Connectors > Add custom connector > paste `https://mcp.chainstack.com/mcp`

### ChatGPT

Settings > Apps & Connectors > Developer mode > Create > paste `https://mcp.chainstack.com/mcp`

## Discovery

Visit [mcp.chainstack.com](https://mcp.chainstack.com/) for an agent-readable onboarding page. Point any agent at this URL (e.g., "get mcp.chainstack.com") and it can read the page and self-configure.

The server is also listed in two public registries, where it appears as `com.chainstack/chainstack`:

* [GitHub MCP Registry](https://github.com/mcp/com.chainstack/chainstack) — the catalog VS Code surfaces in its Extensions view, with one-click install
* [MCP Registry](https://registry.modelcontextprotocol.io/?search=chainstack) — the official registry that MCP clients read from

## Endpoints

| Path       | Description                                          |
| ---------- | ---------------------------------------------------- |
| `/`        | Agent-readable discovery and onboarding page         |
| `/mcp`     | MCP transport (Streamable HTTP)                      |
| `/skill`   | SKILL.md — full usage guide for on-demand skill mode |
| `/healthz` | Liveness probe                                       |
| `/readyz`  | Readiness probe                                      |

## Report issues

Found a bug or something not working as expected? Open an issue:

* [Open a new issue](https://github.com/chainstacklabs/mcp-server/issues/new)
* [View existing issues](https://github.com/chainstacklabs/mcp-server/issues)

Include what tool you called, what you expected, and what happened instead.

## Request features

Have an idea for a new tool or improvement? Open a feature request:

* [Request a feature](https://github.com/chainstacklabs/mcp-server/issues/new)

Describe your use case — what you're trying to accomplish and why the current tools don't cover it.

## Changelog and updates

The changelog is maintained in the repository:

* [View changelog](https://github.com/chainstacklabs/mcp-server/blob/main/CHANGELOG.md)

To get notified of new releases and changes, watch the repository:

1. Go to [chainstacklabs/mcp-server](https://github.com/chainstacklabs/mcp-server)
2. Click **Watch** > **Custom** > select **Releases**
3. You'll receive notifications when new versions are published