Skip to main content

​
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, 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:
ToolDescription
search_docsSearch Chainstack documentation — blockchain RPC methods, deployment guides, code examples
get_doc_pageFetch the full content of a documentation page
get_platform_statusCheck platform status, active incidents, and network health
API key required (get one at console.chainstack.com/user/settings/api-keys):
ToolDescription
get_organizationGet organization name and ID
get_deployment_optionsList available blockchain/cloud/region combinations
list_projectsList all projects
create_projectCreate a new project
get_projectGet project details
update_projectUpdate a project’s name or description
delete_projectDelete a project
list_nodesList all nodes with status and endpoints
get_nodeGet a node’s full details including RPC endpoints
create_nodeDeploy a new blockchain node
update_nodeRename a node
delete_nodeDelete a node

​
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.
AgentSkills 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

PathDescription
/Agent-readable discovery and onboarding page
/mcpMCP transport (Streamable HTTP)
/skillSKILL.md — full usage guide for on-demand skill mode
/healthzLiveness probe
/readyzReadiness probe
Last modified on April 9, 2026