Solana MCP Server

What AiAgentKarl/solana-mcp-server MCP server does

AiAgentKarl/solana-mcp-server MCP server exposes Solana blockchain and market data to an AI agent through 11 MCP tools. It covers wallet balances, transaction history, token metadata, token prices, DeFi yields, whale activity, wallet tracking, portfolio analysis, token safety, and server usage statistics.

The wallet tools can return SOL and token balances, recent transactions with transaction types and descriptions, and portfolio values in USD. Token tools provide current USD prices, using Jupiter first and CoinGecko as a fallback, along with metadata such as name, symbol, supply, and decimals.

For decentralized finance use cases, the server retrieves pool APRs from Raydium and Orca and can compare yields for a particular token across those exchanges. Its safety checks include RugCheck scores, holder concentration, mint authority, and freeze authority. Whale-related tools find large token transactions and follow a wallet’s holdings and activity.

How it works

The server is implemented as a FastMCP application. Its source is organized around a server module, configuration handling, asynchronous HTTP clients for external APIs, and tool definitions grouped by wallet, token, DeFi, and safety functions.

AiAgentKarl/solana-mcp-server MCP server uses Helius for required blockchain API access. Jupiter, CoinGecko, Raydium, Orca, and RugCheck provide the other listed data sources. The README states that Jupiter, Raydium, Orca, and RugCheck do not require API keys, while CoinGecko has a limit of 30 calls per minute. Helius provides a free tier of 1 million credits per month.

Pools with less than $1,000 in total value locked are automatically filtered from the server’s DeFi data. This is relevant when using yield discovery or comparison tools, because very small pools are excluded from the results.

Setup and configuration

Install the Python package with:

pip install solana-mcp-server

Register the server in an MCP client using the solana-server command. The configuration must provide HELIUS_API_KEY in the server’s environment. The key can be obtained from Helius, and the README identifies it as a free key.

A minimal configuration follows:

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

The placeholder value must be replaced with an actual Helius key before starting the server.

Tools and capabilities

AiAgentKarl/solana-mcp-server MCP server includes these capabilities:

• Retrieve SOL and token balances for a wallet.
• Inspect recent transactions with descriptions and types.
• Look up token prices and metadata.
• Find top Raydium and Orca DeFi pool APRs.
• Compare yields for a token across supported exchanges.
• Check RugCheck scores and token authority settings.
• Find large token transactions and track a wallet’s activity.
• Analyze a wallet portfolio with USD values.
• Read server usage statistics.

Limitations and notes

The server depends on external Solana and market-data providers, so results are constrained by those providers’ availability and rate limits. Helius is the only listed provider that requires a key. CoinGecko is documented with a 30-calls-per-minute limit; the README does not state request limits for the other providers.

The available safety data should be treated as tool output for investigation rather than an unstated guarantee about a token. The README specifically identifies RugCheck scores, holder concentration, mint authority, and freeze authority as the checks exposed by the server.