Sonar-MCP
{
"answer": "This server provides an MCP interface to the Solana blockchain via the Helius RPC API, exposing 8 tools across four categories:\n\n- Network: Check the current slot (get_slot), view epoch progress including absolute slot, block height, epoch number, and slot index/total (get_epoch_info), and verify RPC node health (get_health).\n- Wallet: Fetch SOL balance in lamports and SOL (get_sol_balance), and list SPL token accounts owned by a wallet with optional mint filtering (get_token_accounts_by_owner).\n- Transactions: Retrieve full transaction details by signature (get_transaction) and recent signatures for an address with a configurable limit (get_signatures_for_address).\n- Tokens: Query total supply and decimal precision for any SPL token mint (get_token_supply).\n\nMost read tools accept a commitment parameter (defaulting to finalized) for configurable data consistency. Errors return as {\"error\": ...} payloads rather than breaking the MCP session, ensuring graceful degradation."
}
Provides tools for interacting with the Solana blockchain, including network status, wallet balances, token accounts, and transaction details via the Helius RPC API.
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., "@Sonar-MCP Check the SOL balance for 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
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.
Sonar MCP
An MCP server exposing Solana network, wallet, transaction, and token-intelligence tools backed by the Helius RPC API. Built to plug directly into MCP-compatible clients such as Cursor.
Architecture Diagram

Tools
Domain | Tool | Description |
Network |
| Current slot at a given commitment level |
Network |
| Epoch progress: absolute slot, block height, index |
Network |
| RPC node health check |
Wallet |
| SOL balance for a wallet address |
Wallet |
| SPL token holdings for a wallet |
Transactions |
| Full transaction detail by signature |
Transactions |
| Recent transaction signatures for an address |
Tokens |
| Supply and decimals for an SPL token mint |
Related MCP server: Solana AI Terminal
Prerequisites
Setup
git clone <your-repo-url> sonar-mcp
cd sonar-mcp
uv sync
cp .env.example .envEdit .env:
HELIUS_API_KEY=your-key-here
SOLANA_NETWORK=devnet # or mainnetRunning
Launch the MCP Inspector for local testing:
uv run mcp dev src/sonar_mcp/server.pyThis opens a browser UI where each tool can be called directly against Helius before wiring the server into a client.
Using with Cursor
Add to .cursor/mcp.json (project-level) or your global Cursor MCP config:
{
"mcpServers": {
"sonar": {
"command": "uv",
"args": ["run", "--directory", "/absolute/path/to/sonar-mcp", "sonar-mcp"]
}
}
}Reload MCP servers in Cursor and the 8 tools will appear under sonar.
Project structure
sonar-mcp/
├── .env.example
├── pyproject.toml
├── README.md
└── src/
└── sonar_mcp/
├── instance.py # shared MCPServer instance
├── server.py # entrypoint, registers tool modules
├── config.py # env + RPC URL
├── rpc_client.py # shared Helius JSON-RPC POST helper
└── tools/
├── network.py
├── wallet.py
├── transactions.py
└── tokens.pyNotes
Built on MCP Python SDK v2 (
mcp.server.MCPServer). The oldFastMCPclass frommcp.server.fastmcpwas renamed and moved in v2 — if you're reading examples elsewhere that importFastMCP, they're targeting SDK v1.All Solana RPC calls go through Helius directly; this server does not call the original Sonar FastAPI service.
RpcErrorresponses are returned as{"error": ...}payloads rather than raised, so tool calls degrade gracefully instead of crashing the MCP session.
Available Tools
8 toolsget_epoch_infoB
Get current epoch progress: absolute slot, block height, epoch, slot index/total.
Inputs: commitment, min_context_slot.
get_healthA
Check whether the RPC node is healthy.
Inputs: no named parameters.
get_signatures_for_addressB
Get recent transaction signatures involving an address.
Inputs: address (required), limit.
get_slotA
Get the current slot the node has reached, at the given commitment level.
Inputs: commitment.
get_sol_balanceA
Get the SOL balance (in lamports and SOL) for a wallet address.
Inputs: address (required), commitment.
get_token_accounts_by_ownerA
List SPL token accounts owned by a wallet, optionally filtered to one mint.
Inputs: address (required), mint.
get_token_supplyA
Get total supply and decimals for an SPL token mint.
Inputs: mint (required).
get_transactionA
Get full details for a transaction by its signature.
Inputs: signature (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool targets a distinct resource or query, but get_slot and get_epoch_info overlap slightly since both report the current slot. The descriptions clarify their different scopes, so ambiguity is minimal.
All tool names follow a consistent verb_noun pattern with the 'get_' prefix. Variations like get_epoch_info or get_token_supply still adhere to the pattern, and there is no mixing of styles.
Eight tools is well within the ideal range and appropriate for a read-only Solana RPC server. Each tool provides a needed query without bloat or redundancy.
The set covers core Solana read operations: slot, epoch, health, balances, token accounts, transactions, signatures, and supply. Missing queries like get_block or get_program_accounts are minor gaps, and the server's scope is clearly read-only.
Related MCP Connectors
Helius MCP — deeper Solana wallet/asset data than solscan (helius.dev)
Run all your Solana wallets from your AI: send, swap, split, consolidate and clean up.
Solana MCP for wallets, trades, markets, PnL, transfers, onchain data, signable swaps and API tools.
Provide AI agents and automation tools with contextual access to blockchain data including balance…
Related MCP Servers
- AlicenseCqualityDmaintenanceA Model Context Protocol server that provides Claude with comprehensive access to Solana blockchain data via the Helius API, enabling operations like checking wallet balances, retrieving blockchain information, and interacting with tokens and NFTs.3824 npm14MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with the Solana blockchain network, supporting documentation search, blockchain queries, wallet management, and cryptographic signing operations on Devnet and Testnet.MIT
- AlicenseNot gradedqualityCmaintenanceProvides basic Solana RPC methods and prompts for AI models to interact with the Solana blockchain. Enables developers to fetch balances, account info, and transactions through natural language.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude to access, analyze, and visualize Solana blockchain data through natural language conversations.18MIT