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

MCP Servers