Solana Rpc MCP server

@pipeworx/solana-rpc

SPL token holdings, SOL balance and transaction history for any Solana address, and the top holders of any SPL token mint, read live from public Solana JSON-RPC endpoints — no API key.

Part of Pipeworx — an MCP gateway connecting AI agents to 1576+ live data sources.

Tools

a wallet holds: mint address, balance, decimals, token-account address, across both the SPL Token and Token-2022 programs. Zero balances dropped, sorted largest first, paginated.

• solanawallettokens(wallet, limit?, offset?, minamount?, includezero?, program?) — every SPL token position

success/failure and memo, newest first; next_before pages further back.

• solanawalletbalance(wallet) — native SOL balance in lamports and SOL, with the slot it was read at.
• solanawallettransactions(wallet, limit?, before?, until?) — recent signatures with block time, slot,

types invoked, SOL balance changes, SPL token balances before and after, first log lines.

• solana_transaction(signature) — one transaction summarised: fee, status, signers, programs and instruction

each with its owner wallet, token-account address, raw and decimal balance and percentage of total supply; plus the mint's supply, decimals and the share the returned holders control together. 20 holders from most endpoints, up to 100 where the node allows.

• solanatokenholders(mint, limit?) — the largest token accounts of an SPL token mint, ranked by balance,

and you need to tell an endpoint block apart from an idle wallet.

• solanarpchealth() — live per-endpoint, per-method reachability probe. Use it when a lookup comes back empty

Auth

Keyless.

Data sources

only keyless endpoint found that serves getTokenLargestAccounts; first in line for mint-level calls, last resort for wallet calls.

• — Solana mainnet JSON-RPC operated by PublicNode/Allnodes.
• — Solana mainnet JSON-RPC operated by LeoRPC (free shared key).
• — Solana mainnet JSON-RPC operated by MagicBlock (public endpoint). The

Things worth knowing before you touch this

The endpoint that works on your laptop is not the endpoint that works in production. api.mainnet-beta.solana.com returns 200 locally and HTTP 403 "Your IP or provider is blocked from this endpoint" from a Cloudflare Worker. Twelve free RPC endpoints were probed from a deployed Worker; ankr, rpcpool and mainnet-beta 403, drpc 400s for a paid plan, blockeden 402, onfinality and omniatech 429, grove 1016, public-rpc 526, shyft 401. Two survived, and neither serves everything:

So failover is the architecture, not a safety net. Calls walk PROVIDERS in order, retry once on a transient failure, and skip a provider that refuses the method outright (-32601/-32602/-32000/403). A refusal is remembered per isolate so later calls go straight to the endpoint that serves it; a flake is not remembered, because flakes recover. Every response carries providers_tried with the outcome and latency of each hop, so a caller can see exactly where the answer came from.

Shortened. The full README is on GitHub.