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

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.chainstack.com/feedback

```json
{
  "path": "/docs/chainstack-mcp-server",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# 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"
      }
    }
  }
}
```

### GitHub Copilot (VS Code)

Edit `.vscode/mcp.json` (workspace) or use Command Palette > "MCP: Open User Configuration" (global):

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

<Note>
  GitHub Copilot uses `servers` as the root key, not `mcpServers`.
</Note>

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

## 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