solana-mcp-server
# solana-mcp-server
**Solana blockchain data for AI agents** — wallet balances, token prices, DeFi yields, whale tracking, and token safety checks.
[](https://pypi.org/project/solana-mcp-server/)
[](https://opensource.org/licenses/MIT)
[](https://smithery.ai/server/@AiAgentKarl/solana-mcp-server)
> Real-time Solana data from **Helius, Jupiter, CoinGecko, Raydium, Orca, and RugCheck**. Scam-pools auto-filtered (< $1,000 TVL).
## Quick Start
```bash
pip install solana-mcp-server
```
Add to your MCP client config:
```json
{
"mcpServers": {
"solana": {
"command": "solana-server",
"env": {
"HELIUS_API_KEY": "your-free-key-from-helius.dev"
}
}
}
}
```
Get your free Helius key at [dev.helius.xyz](https://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](https://pypi.org/project/cybersecurity-mcp-server/) — CVE database & vulnerability intelligence
- [news-aggregator-mcp-server](https://pypi.org/project/news-aggregator-mcp-server/) — Multi-source news aggregation
## License
MIT
TDQS
Scored across 8 tools
Each tool has a clearly distinct purpose with no overlap: token safety checks, yield comparisons, DeFi yield listings, token metadata, token pricing, transaction history, usage statistics, and wallet balances. The descriptions reinforce unique functions, making tool selection unambiguous for an agent.
All tool names follow a consistent verb_noun pattern using snake_case (e.g., check_token_safety, get_token_info, get_wallet_balance). The naming is predictable and readable throughout the set, with no deviations in style.
With 8 tools, the server is well-scoped for Solana analytics and DeFi operations. Each tool serves a distinct, valuable function in the domain, and the count is neither too sparse nor bloated, fitting typical server expectations.
The toolset covers key Solana DeFi and wallet operations comprehensively, including token analysis, pricing, yields, and wallet data. A minor gap exists in transaction execution tools (e.g., swap or transfer tokens), but agents can work around this for most analytical workflows.