solana-readonly-mcp
Read-only Solana MCP server for Claude, Cursor and AI agents
Lets Claude, Cursor, VS Code or any MCP client look up Solana balances, token holdings, transactions, mints and priority fees. It holds no private key and cannot sign. Zero dependencies.
Install in Claude Code
claude mcp add solana -- npx -y github:blixvip/solana-readonly-mcp
Then ask Claude "What tokens does wallet 8emnM6nf... hold?" or "Why did transaction 5eJQVYWM... fail?". Claude Desktop, Cursor, VS Code and Windsurf use a JSON config instead; the Claude guide, the Cursor guide and the VS Code and Windsurf guide have the exact files.
Nine read-only tools
| Tool | What it answers |
|---|---|
get_balance | SOL balance of any address |
get_token_accounts | Every token a wallet holds (Token Program and Token-2022) |
get_account_info | Owner program, lamports, data size, parsed data |
get_transaction | Status, error, fee, signers, programs, SOL and token balance changes |
get_signatures | Recent signatures for an address, pageable |
get_token_supply_and_authorities | Supply, decimals, mint and freeze authority, Token-2022 extensions |
get_largest_token_holders | The 20 largest token accounts of a mint, with share of supply |
get_priority_fees | Recent priority fees as min / median / p75 / p90 / max |
get_slot_and_health | Slot, epoch progress, node version, health |
Why read-only
- No private key goes in, so nothing can be signed. There is no key setting at all.
- The RPC client refuses any method outside a fixed read list, so
sendTransactioncannot be sent. - Every tool is marked
readOnlyHint: true, so clients can run them without asking you each time. - The RPC URL is never printed, so an API key in it stays out of the chat.
Example output
Talk to it by hand over stdio, the way an MCP client does:
printf '%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"me","version":"0"}}}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_slot_and_health","arguments":{}}}' \
| npx -y github:blixvip/solana-readonly-mcp
The get_slot_and_health answer from public mainnet on 2026-11-17 (shortened):
{
"rpc": "api.mainnet-beta.solana.com",
"slot": 470716490,
"blockHeight": 448731257,
"epoch": 1089,
"epochProgressPct": 62.15,
"solanaCore": "4.4.0",
"health": "ok",
...
}
Use it from your own code
npm install github:blixvip/solana-readonly-mcp
import { createServer } from "solana-readonly-mcp";
const server = createServer({ rpcUrl: process.env.SOLANA_RPC_URL });
const r = await server.callTool("get_balance", { address: "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4" });
console.log(r.structuredContent);
// { address: 'JUP6Lkb...', lamports: 6987116527, sol: 6.987116527, slot: 470716396 }
Full documentation, the API and the limits are in the README. There is a server.json for the official MCP Registry. MIT licensed, no dependencies.
Guides
- How to give Claude access to Solana data with MCP
- Solana MCP server for Cursor: setup
- Solana MCP server in VS Code and Windsurf: config files that work
From the team behind Blix
solana-readonly-mcp is a small, open piece of what runs behind Blix, the AI-powered Solana memecoin terminal with 0% fees: every pump.fun launch live, AI coin ratings, narratives, wallet and X tracking, and one-click trading. If you want the result rather than the plumbing, start trading at blixvip.com. There is also a public API and an MCP server for AI agents.
Contribute
Pull requests are welcome and there are good first issues with step-by-step instructions. Setup is git clone and npm test. Ideas and questions go in Discussions or the Discord.