Get Yellowstone gRPC streaming for $49/month! Access real-time Solana blockchain data.    Learn more
  • Pricing
  • Docs

How to сonnect Chainstack MCP server to Claude

Created Apr 28, 2026 Updated Apr 28, 2026
Yh5baeaaaaalaaaaaabaaeaaaibraa7 logo

What if Claude could check an Ethereum wallet balance, deploy a Solana node, or search Chainstack’s docs — all from a single prompt?

With the Chainstack MCP server, it can. MCP (Model Context Protocol) is an open standard by Anthropic that lets Claude talk directly to external tools and APIs. Connect it to Chainstack and your AI assistant gets live access to 70+ blockchain networks, your node infrastructure, and the full Chainstack documentation — without leaving your IDE or chat window.

This guide walks you through setup for Claude Desktop, Claude.ai, and Claude Code.

What is the Chainstack MCP server

MCP (Model Context Protocol) is an open standard by Anthropic that gives Claude secure, structured access to external tools and APIs.

Chainstack is a blockchain infrastructure provider (RPC nodes for 70+ networks: Ethereum, Solana, Base, Polygon, Arbitrum, and more). Chainstack MCP server lets Claude:

ServerURL / repoTransportStatus
Chainstack MCP (unified)https://mcp.chainstack.com/mcpStreamable HTTP✅ Current

Available tools

No API key required:

ToolWhat it does
search_docsSearch Chainstack documentation — RPC methods, deployment guides, code examples
get_doc_pageFetch the full content of any documentation page
get_platform_statusCheck platform status, active incidents, and network health
get_chainstack_pricingGet current pricing information
contact_chainstackReach the Chainstack team

API key required (get one at console.chainstack.com/user/settings/api-keys):

ToolWhat it does
get_organizationGet your organization name and ID
get_deployment_optionsList available blockchain, cloud, and region combinations
list_projectsList all your 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
request_testnet_fundsRequest testnet tokens

Prerequisites

  1. Claude account — a paid plan is required for remote MCP via “Custom Connectors”; any plan works for claude_desktop_config.json.
  2. Claude Desktop — download at claude.ai/download and sign in with your Anthropic account.
  3. Node.js ≥ 18 — required for npx. Check with: node -v.
  4. Chainstack account — sign up at console.chainstack.com/user/account/create. Create an API key under Settings → API Keys (shown only once — save it).
  5. Optional Claude Code CLI: npm install -g @anthropic-ai/claude-code.

Where Is claude_desktop_config.json

OSPath
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json

Quickest way to open it: Claude → Settings → Developer → Edit Config — the file will be created automatically if it doesn’t exist.

Connecting to Claude

A cloud server combining documentation search, platform management, and RPC access. No local installation needed.

Quickest setup

Paste this into Claude Code or Claude Desktop chat:

get mcp.chainstack.com

The agent will open the discovery page and handle all configuration steps automatically.

Option 1: Install as a skill (Claude Code)

A lightweight alternative to full MCP registration — the skill file tells Claude Code how to call Chainstack tools on demand without adding them permanently to context. Best if you don’t need Chainstack tools in every session.

bash

mkdir -p ~/.claude/skills/chainstack
curl -o ~/.claude/skills/chainstack/SKILL.md https://mcp.chainstack.com/skill

Restart Claude Code or start a new session. Claude will automatically pick up the skill.

Option 2: Register as MCP server

Chainstack tools are always available in context. Use any of the methods below.

Claude Desktop — via mcp-remote

Claude Desktop only supports stdio natively — connect remote HTTP servers using the mcp-remote proxy. Add to claude_desktop_config.json:

json

{
  "mcpServers": {
    "chainstack": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.chainstack.com/mcp"]
    }
  }
}

Fully quit Claude Desktop (Cmd+Q on macOS) and relaunch. A 🔨 tools indicator should appear in the chat input area.

Claude.ai / Claude Desktop — via “Custom Connectors”

Go to Settings → Connectors → Add custom connector and enter: https://mcp.chainstack.com/mcp.

Claude Code CLI

bash

claude mcp add --transport http chainstack https://mcp.chainstack.com/mcp
# Available across all projects:
claude mcp add --transport http chainstack https://mcp.chainstack.com/mcp --scope user
# Verify:
claude mcp list

Passing the Chainstack Platform API key

bash

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

Example prompts

EVM:

  • “Get the ETH balance of 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum mainnet.”
  • “Trace transaction 0xabc…def and explain what happened step by step.”
  • “Simulate this transaction with a modified sender balance.”

Solana:

  • “What’s the SOL balance of Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr?”
  • “Get recent prioritization fees and recommend a priority fee for a swap.”

Documentation:

  • “How do I enable the Yellowstone gRPC Geyser plugin on my Chainstack Solana node?”
  • “Which chains on Chainstack support Warp transactions?”

Platform operations (unified MCP):

  • “Deploy a new Chainstack Global Node on Ethereum mainnet.”
  • “Scan my repo for RPC URLs and suggest Chainstack replacements.”

Troubleshooting

ProblemSolution
🔨 indicator not showingFully quit Claude Desktop (Cmd+Q / Quit from tray) — config is only read on startup
JSON parse errorValidate claude_desktop_config.json with a JSON linter — a stray comma or bracket breaks everything
npx not foundUse the full path in command (find it with which npx)
Relative path errorAll paths in args must be absolute
Streamable HTTP not workingClaude Desktop doesn’t support remote HTTP natively — wrap with npx mcp-remote <URL>
401 Unauthorized on RPCChainstack endpoints already embed credentials in the URL — no Authorization header needed
Platform actions failingCreate a Platform API key under Settings → API Keys and pass it via --header "Authorization: Bearer KEY"
Logs for debuggingmacOS: ~/Library/Logs/Claude/mcp*.log · Windows: %APPDATA%\Claude\logs\

Conclusion

Once connected, Chainstack MCP turns Claude into a live blockchain development assistant — you can query on-chain data, deploy and manage nodes, and search Chainstack’s documentation without leaving your IDE or chat interface. The unified server at mcp.chainstack.com/mcp requires no local setup and works across Claude Desktop, Claude.ai, and Claude Code.

For node management and platform operations, grab your API key at console.chainstack.com/user/settings/api-keys — public tools like documentation search and platform status work without one.

FAQ

Do I need a paid Claude plan to use Chainstack MCP?

For Claude Desktop via claude_desktop_config.json — any plan works. For remote MCP via “Custom Connectors” in Claude.ai — a paid plan is required.

Do I need a Chainstack API key?

Not for documentation search, platform status, and contacting Chainstack. You do need one for node deployment and project management. Get it at console.chainstack.com/user/settings/api-keys.

What chains does Chainstack MCP support?

All chains available on the Chainstack platform — including Ethereum, Solana, Base, Polygon, Arbitrum, and more. See the full list at chainstack.com/protocols.

Claude Desktop shows no tools after setup — what’s wrong?

Make sure you fully quit Claude Desktop (not just close the window) before relaunching. The config file is only read on startup. Also validate your claude_desktop_config.json with a JSON linter — a single stray comma breaks parsing silently.

Can I use Chainstack MCP without Claude Desktop?

Yes. Claude Code CLI (claude mcp add --transport http chainstack https://mcp.chainstack.com/mcp) and Claude.ai via Custom Connectors both work without Claude Desktop.

Related reading

SHARE THIS ARTICLE
Token Metadata Solana

Token metadata on Solana: from convention to data

Where does token metadata live on Solana, and how does the runtime find it? This article explains how token metadata is derived through conventions, PDAs, and explicit accounts.

Logo Chainstack 150x150 logo
Developer Hub Guest
Jan 15
Customer Stories

Eldarune

Eldarune successfully tackled multichain performance bottlenecks for a superior AI-driven Web3 gaming experience.

BonusTrade.AI

BonusTrade.AI unlocks real-time crypto market insights with low latency and high-performance Chainstack infrastructure.