Content
# 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
