Skip to main content

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.

​
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

​
Report issues

Found a bug or something not working as expected? Open an issue: 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: 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: 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
Last modified on April 13, 2026