AiAgentKarl/solana-mcp-server

Solana blockchain data for AI agents — wallet balances, token prices, DeFi yields, whale tracking, and token safety checks.

PyPI version License: MIT Smithery

Real-time Solana data from Helius, Jupiter, CoinGecko, Raydium, Orca, and RugCheck. Scam-pools auto-filtered (< $1,000 TVL).

Quick Start

pip install solana-mcp-server

Add to your MCP client config:

{
  "mcpServers": {
    "solana": {
      "command": "solana-server",
      "env": {
        "HELIUS_API_KEY": "your-free-key-from-helius.dev"
      }
    }
  }
}

Get your free Helius key at dev.helius.xyz (1M credits/month free).

What Can You Do?

Ask your AI agent things like:

• "What tokens does this wallet hold?"
• "What's the current price of SOL?"
• "Show me the best DeFi yields on Solana right now"
• "Is this token safe? Check the RugCheck score"
• "What are whales doing with JUP?"

11 Tools

Tool	What it does
get_wallet_balance	SOL + token balances of any wallet
get_transaction_history	Recent transactions with type and description
get_token_price	Current USD price (Jupiter primary, CoinGecko fallback)
get_token_info	Token metadata: name, symbol, supply, decimals
get_defi_yields	Top DeFi pool APRs from Raydium + Orca
compare_yields	Compare yields for a specific token across DEXs
check_token_safety	RugCheck score, holder concentration, mint/freeze authority
get_whale_transactions	Large transactions for a token
track_smart_wallet	Track a whale wallet's holdings and activity
analyze_wallet_portfolio	Full portfolio analysis with USD values
get_usage_stats	Server usage statistics

API Keys

API	Free Tier	Key Required?
Helius	1M credits/month	Yes (free)
Jupiter	Unlimited	No
CoinGecko	30 calls/min	No
Raydium	Unlimited	No
Orca	Unlimited	No
RugCheck	Unlimited	No

Architecture

src/
├── server.py       # FastMCP server
├── config.py       # API key config via .env
├── clients/        # Async HTTP clients (one per API)
└── tools/          # MCP tool definitions (wallet, token, defi, safety)

Related Servers

• cybersecurity-mcp-server — CVE database & vulnerability intelligence
• news-aggregator-mcp-server — Multi-source news aggregation

License

MIT