solana-mcp
The solana-mcp server provides read-only tools to query Solana blockchain data without signing or sending transactions. It includes:
get_sol_price– Fetches the current SOL price in USD via CoinGecko.get_wallet_balance– Retrieves the native SOL balance of a given wallet address on mainnet.get_token_balances– Lists all non-zero SPL token (including Token-2022) balances held by a wallet address.get_recent_transactions– Returns the most recent transactions for a wallet (newest first), with details like slot, timestamp, and success/failure status. Accepts a limit between 1 and 50 (default 10).
Provides read-only Solana blockchain superpowers, including SOL price lookups, wallet balance checks, SPL token balance queries, and recent transaction history for any Solana wallet address.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@solana-mcp What's the balance of wallet 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
solana-mcp
A Model Context Protocol server that lets an AI assistant query Solana without signing anything. Four read-only tools over stdio: current SOL price, native wallet balance, SPL and Token-2022 balances, and recent transactions. Addresses are validated before any RPC call, and transient failures (429, 5xx, timeouts) retry with exponential backoff.
14 tests, all passing. Typecheck clean. CI runs on Node 18, 20, and 22. MIT. Built for Claude Desktop and any MCP client.
Published on npm as
solana-execution-mcp. The plainsolana-mcpname was already taken by an unrelated package.
npx solana-execution-mcpTools
Tool | Input | Returns |
| none | Current SOL price in USD (via CoinGecko). |
|
| Native SOL balance of the wallet (mainnet). |
|
| Non-zero SPL token balances held by the wallet (Token + Token-2022). |
|
| Most recent transactions for the wallet, newest first, with slot, timestamp, and success/failure. |
Wallet addresses are validated before any RPC call, and every tool returns a clean error message instead of crashing on bad input or upstream failures. Network calls (RPC and price API) retry automatically with exponential backoff on transient failures — rate limits (HTTP 429), 5xx, and timeouts — and surface a clean error if the endpoint stays unavailable.
Related MCP server: Corvus
Requirements
Node.js 18+ (uses the built-in
fetch)
Install
npx solana-execution-mcpThat is the whole install. npx fetches the package and runs the server on stdio, so there is nothing to clone and no build directory to point at.
From source
Only needed if you want to modify it:
git clone https://github.com/Tobiinsaurralde/solana-mcp.git
cd solana-mcp
npm install
npm run buildScripts
Script | Description |
| Compile TypeScript to |
| Run the compiled server ( |
| Recompile on change ( |
| Run the unit tests ( |
| Type-check without emitting. |
| Remove |
Tests
npm testUnit tests cover address validation, the price tool (success, bad shape, and the rate-limit retry path with a mocked fetch), and the retry/backoff logic. They run directly against the TypeScript sources and make no network calls.
Configuration
Optional, read from the environment:
Variable | Default | Purpose |
|
| RPC endpoint for balance lookups. The public endpoint is rate-limited — use your own (Helius, QuickNode, Triton, …) for anything beyond light use. |
Connect to Claude Desktop
Open your Claude Desktop config file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Add the server under
mcpServers:{ "mcpServers": { "solana": { "command": "npx", "args": ["-y", "solana-execution-mcp"], "env": { "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com" } } } }Restart Claude Desktop. The four tools appear under the 🔌 (tools) menu.
Build first (npm run build), then point at the compiled entrypoint with an absolute path:
{
"mcpServers": {
"solana": {
"command": "node",
"args": ["/absolute/path/to/solana-mcp/dist/index.js"]
}
}
}Then ask things like:
"What's the price of SOL right now?"
"What's the SOL balance of
9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM?""List the token balances for that wallet."
Project structure
src/
index.ts # MCP server: registers the 4 tools, wires stdio transport
config.ts # Endpoints, program ids, and env-overridable settings
price.ts # SOL/USD price lookup
solana.ts # Address validation + SOL/SPL balance + recent-tx logic
http.ts # fetch() with timeout, JSON parsing, clean errors
retry.ts # Transient-error detection + exponential-backoff retry
errors.ts # ToolError type + error description helper
test/
validation.test.ts # Address validation
price.test.ts # Price tool (incl. rate-limit retry)
retry.test.ts # Retry / backoff logicNotes
This server is read-only — it never signs or sends transactions.
Logs are written to
stderrso they never corrupt the stdio JSON-RPC stream.
License
MIT
Available Tools
4 toolsget_recent_transactionsGet Recent TransactionsA
List the most recent transactions for a Solana wallet address, newest first.
Inputs: address (required), limit.
get_sol_priceGet SOL PriceA
Get the current price of SOL in USD.
Inputs: no named parameters.
get_token_balancesGet SPL Token BalancesA
List the non-zero SPL token balances held by a Solana wallet address.
Inputs: address (required).
get_wallet_balanceGet Wallet SOL BalanceA
Get the native SOL balance of a Solana wallet address (mainnet).
Inputs: address (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct data type: price, native balance, token balances, and transaction history. There is no overlap in purpose, making tool selection unambiguous.
All tool names follow a consistent get_ prefix with snake_case, clearly indicating read-only operations. The pattern is uniform across the entire set.
With 4 tools, the server is tightly scoped for its purpose of providing Solana blockchain data lookups. Each tool covers a distinct useful query without unnecessary bloat.
The set covers core Solana data retrieval needs: price, native balance, token balances, and transactions. Minor gaps like transaction details or token metadata are not covered, but the essential surface is present.
Related MCP Connectors
Solana MCP for wallets, trades, markets, PnL, transfers, onchain data, signable swaps and API tools.
Run all your Solana wallets from your AI: send, swap, split, consolidate and clean up.
Native Solana staking for AI agents. 26 MCP tools, one-shot signing, webhooks.
Solana tools over MCP: Jupiter swaps, SPL tokens, Metaplex NFTs, SNS domains, network stats.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA simple MCP server implementation that provides AI models with basic Solana RPC methods and helpful development prompts.4 npm43MIT
- AlicenseAqualityDmaintenanceSolana DeFi Intelligence MCP server enabling natural language queries for wallet analytics, DeFi positions, protocol metrics, and token prices.81MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that connects Hermes Agent to the Solana blockchain, enabling natural language queries for wallets, tokens, NFTs, transactions, whale movements, and network health.6MIT
- AlicenseAqualityDmaintenanceProvides read-only access to Solana on-chain data, enabling natural language queries for wallet balances, token holdings, prices, transactions, and more via MCP-compatible clients.8MIT