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) 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). 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 — 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/

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

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

# 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

codex mcp add chainstack --url https://mcp.chainstack.com/mcp

Or edit ~/.codex/config.toml:

[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):

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

Windsurf

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

{
  "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):

{
  "servers": {
    "chainstack": {
      "type": "http",
      "url": "https://mcp.chainstack.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

GitHub Copilot uses servers as the root key, not mcpServers.

Gemini CLI

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

{
  "mcpServers": {
    "chainstack": {
      "httpUrl": "https://mcp.chainstack.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Gemini CLI uses httpUrl for Streamable HTTP endpoints, not url.

Antigravity

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

{
  "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 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
• View existing 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

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

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

1. Go to chainstacklabs/mcp-server
2. Click Watch > Custom > select Releases
3. You’ll receive notifications when new versions are published