swiftnodes-mcp
An MCP (Model Context Protocol) server for SwiftNodes — multi-chain blockchain RPC, exposed to AI agents.
One API key, 125+ chains, flat-rate pricing. This server gives Claude, ChatGPT, Cursor, and any MCP client live, factual answers about chains, pricing, and JSON-RPC method support — plus the ability to probe any EVM endpoint directly.
Hosted server (recommended)
SwiftNodes runs this server for you at https://rpc.swiftnodes.io/mcp (Streamable HTTP). Nothing to install.
claude mcp add --transport http --scope user swiftnodes https://rpc.swiftnodes.io/mcp --header "Authorization: Bearer $SWIFTNODES_API_KEY"
Cursor and other clients (~/.cursor/mcp.json):
{ "mcpServers": { "swiftnodes": { "url": "https://rpc.swiftnodes.io/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }
The key is optional: without it the public tools below work. With it, two more tools are available:
| Tool | What it does |
|---|---|
rpc_call |
Make a JSON-RPC call on any SwiftNodes chain with your key (counts against your plan like any request). |
get_account |
Your plan, rate limits, requests used this month, and the IP/origin restrictions on the key. Never returns key values. |
Listed in the official MCP Registry as io.swiftnodes/swiftnodes. Docs: https://swiftnodes.io/docs/mcp
Tools
| Tool | What it does |
|---|---|
list_chains |
Every chain SwiftNodes serves — name, slug, chain ID, category, docs page. Filterable. |
get_chain |
Full detail for one chain: IDs, block time, native currency, HTTP/WebSocket/archive endpoint templates, docs links. |
get_pricing |
Live flat-rate plans from the public API — rate limits, included features, no compute units. |
get_method_support |
Which JSON-RPC methods work on which chain — auto-probed weekly through the same path customer requests take. Overview or per-method detail. |
probe_endpoint |
Diagnose any EVM JSON-RPC endpoint (ours or anyone's): chain identity, block height, archive capability, latency — or run a specific method call. |
Run it locally (stdio)
Zero dependencies, Node >= 18.
From this repo:
git clone https://github.com/swiftnodes/swiftnodes-mcp
node swiftnodes-mcp/bin/server.js # speaks MCP over stdio
Via npm (once published): npx -y swiftnodes-mcp
Claude Desktop
{
"mcpServers": {
"swiftnodes": {
"command": "node",
"args": ["/path/to/swiftnodes-mcp/bin/server.js"]
}
}
}
Cursor / any MCP client
Add a stdio server with command node and args ["/path/to/swiftnodes-mcp/bin/server.js"].
Data sources
- Chains — bundled snapshot generated from the SwiftNodes site source of truth (
scripts/generate-chains-data.mjs; regenerate after chain changes). - Pricing — fetched live from
https://rpc.swiftnodes.io/api/plans(bundled fallback if unreachable). - Method support — fetched live from
https://swiftnodes.io/method-matrix.json, re-probed weekly. Support values reflect the real customer path, including failover.
Notes
probe_endpoint will call any http(s) URL you give it — the same ground our CLI diagnostic rpc-doctor covers. Probe responsibly: one quick pass per endpoint, not a load test.
Questions: swiftnodes.io — free tier, no KYC.
License
MIT — see LICENSE.
