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.

View on GitHubStart trading at blixvip.comJoin the Discord

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

ToolWhat it answers
get_balanceSOL balance of any address
get_token_accountsEvery token a wallet holds (Token Program and Token-2022)
get_account_infoOwner program, lamports, data size, parsed data
get_transactionStatus, error, fee, signers, programs, SOL and token balance changes
get_signaturesRecent signatures for an address, pageable
get_token_supply_and_authoritiesSupply, decimals, mint and freeze authority, Token-2022 extensions
get_largest_token_holdersThe 20 largest token accounts of a mint, with share of supply
get_priority_feesRecent priority fees as min / median / p75 / p90 / max
get_slot_and_healthSlot, epoch progress, node version, health

Why read-only

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.

BLIX: AI-powered Solana memecoin terminal. Trade memes first.

Guides

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.

More Solana tools from Blix

solana-priority-feeThe compute unit price recent blocks landed at, plus the Compute Budget instruction bytessol-holdersTop holders of any Solana token, grouped by wallet, pools left outpump-curveRead a pump.fun bonding curve: price, market cap, progress, migrationsolana-rpc-poolA Solana RPC load balancer: several endpoints, rate limits, failoversolana-ws-keepaliveSolana WebSocket subscriptions that reconnect on their own