Solana MCP Server

A production-grade Model Context Protocol server for interacting with the Solana blockchain. Gives AI agents (Claude, Cursor, etc.) the ability to read chain data, execute transactions, swap tokens, manage wallets, and more.

38 tools across 7 modules: Wallet, SPL Tokens, DeFi, NFT, Programs, Analytics, Network.

Quick Start

npx @visioneth/solana-mcp@latest

Claude Desktop / Cursor

Add to your MCP configuration:

{
  "mcpServers": {
    "solana-mcp": {
      "command": "npx",
      "args": ["-y", "@visioneth/solana-mcp@latest"],
      "env": {
        "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com"
      }
    }
  }
}

For write operations (transfers, swaps, minting), add your private key:

{
  "env": {
    "PRIVATE_KEY": "your_base58_private_key",
    "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com"
  }
}

SSE Mode (Remote)

npx @visioneth/solana-mcp@latest --sse
# Server starts on http://localhost:3001

Tools

Wallet (7 tools)

Tool	Description
get_balance	SOL balance of any address
get_account_info	Detailed account info
transfer_sol	Send SOL
request_airdrop	Test SOL on devnet/testnet
get_transaction	Transaction details by signature
get_recent_transactions	Recent transactions for an address
get_wallet_address	Public key from configured private key

SPL Tokens (7 tools)

Tool	Description
get_token_balance	Token balance for a wallet
get_token_info	Mint info (supply, decimals, authorities)
get_token_accounts	All token holdings
create_token	Create new SPL token
mint_tokens	Mint tokens to an address
transfer_token	Transfer SPL tokens
burn_tokens	Burn SPL tokens

DeFi (4 tools)

Tool	Description
get_token_price	USD price via Jupiter
get_swap_quote	Jupiter swap quote with routing
execute_swap	Execute swap on Jupiter
get_stake_accounts	Staking info for a wallet

NFT (3 tools)

Tool	Description
get_nft_metadata	On-chain NFT metadata
get_nfts_by_owner	All NFTs in a wallet
get_nft_collection_info	Collection info from sample NFT

Programs (4 tools)

Tool	Description
is_program	Check if address is executable
get_program_accounts	Accounts owned by a program
read_account_data	Raw account data
identify_program	Look up known programs

Analytics (5 tools)

Tool	Description
get_tps	Current transactions per second
get_largest_token_holders	Top holders of any token
get_token_supply	Total supply info
get_sol_price	Current SOL price in USD
get_largest_accounts	Biggest SOL holders

Network (8 tools)

Tool	Description
get_epoch_info	Current epoch and progress
get_slot	Current slot number
get_block_height	Current block height
get_block	Block details by slot
get_cluster_nodes	Validator/node info
get_supply	Total and circulating SOL
get_minimum_balance_for_rent	Rent exemption calculator
get_health	RPC node health check

Prompts

Built-in prompts for common workflows:

• analyze_wallet — Full wallet analysis
• inspect_transaction — Transaction deep-dive
• analyze_token — Token due diligence with risk score
• portfolio_check — All holdings summary
• swap_analysis — Pre-swap analysis
• analyze_nft — NFT metadata analysis
• analyze_program — Program investigation
• token_research — Comprehensive token research
• network_health — Network status dashboard
• solana_overview — Full network overview

Safety

• Write operations require explicit network specification — the server will never default to mainnet for transactions
• Private key only needed for writes — read-only tools work without credentials
• Confirmation prompts before executing state-changing operations
• All amounts use human-readable UI values (not raw lamports)

Development

git clone https://github.com/visioneth/solana-mcp.git
cd solana-mcp
npm install
cp .env.example .env
npm run dev        # stdio mode
npm run dev:sse    # SSE mode

Environment Variables

Variable	Required	Description
PRIVATE_KEY	For writes	Base58-encoded Solana private key
SOLANA_RPC_URL	No	Custom RPC endpoint (defaults to mainnet-beta)
LOG_LEVEL	No	DEBUG, INFO, WARN, ERROR (default INFO)
PORT	No	SSE server port (default 3001)

Supported Networks

• mainnet-beta — Production (real funds)
• devnet — Development and testing
• testnet — Validator testing

License

MIT