README.md
AI-powered crypto trading MCP server with technical analysis and execution.
@blockrun/alpha
AI-powered crypto trading MCP server with technical analysis, sentiment, and execution tools.
Installation
claude mcp add alpha npx @blockrun/alpha
Tools
| Tool | Description |
|---|---|
alpha_signal |
Technical analysis (RSI, MACD, EMA) via CoinGecko |
alpha_dex |
DEX market data via DexScreener |
alpha_sentiment |
Social sentiment analysis (requires BlockRun wallet) |
alpha_swap |
Token swap quotes + execution on Base |
alpha_portfolio |
Position tracking and management |
alpha_memory |
Vector-based trade memory search |
alpha_risk |
Risk management checks |
alpha_extensions |
Discover additional MCPs (Nansen, Dune, etc.) |
Usage Examples
> "Get ETH technical signals"
Uses alpha_signal to fetch RSI, MACD, EMA indicators
> "Check PEPE market data"
Uses alpha_dex for DexScreener data
> "Find similar trades to ETH breakout"
Uses alpha_memory for semantic search
> "Check if $500 ETH buy passes risk limits"
Uses alpha_risk to validate against position limits
> "Swap 100 USDC for ETH"
Uses alpha_swap with execute=true to swap on Base
Data Sources
- CoinGecko API - Price data and technical indicators (free)
- DexScreener - DEX market data (free)
- Swap Aggregators - Uses first available:
- 1inch (set
ONEINCH_API_KEY) - 0x (set
ZEROX_API_KEY) - Paraswap (no key required, default fallback)
- 1inch (set
- BlockRun Twitter - Sentiment analysis (paid, requires wallet)
Environment Variables
| Variable | Required | Description |
|---|---|---|
ONEINCH_API_KEY |
No | 1inch API key for best rates |
ZEROX_API_KEY |
No | 0x API key as alternative |
| (none) | - | Falls back to Paraswap (free, no key) |
Risk Limits (Hardcoded)
| Rule | Value |
|---|---|
| Max position size | 15% |
| Max total exposure | 50% |
| Daily loss limit | 5% |
| Min cash reserve | 50% |
| Stop loss | 15% |
Data Storage
Data is stored locally in ~/.blockrun/alpha/alpha.db:
- Portfolio positions
- Trade history
- Trade memory with vector embeddings
Requirements
- Node.js 18+
- BlockRun wallet (optional, for sentiment and swaps)
Extend with More MCPs
Use alpha_extensions to discover additional capabilities:
| MCP | What it adds | Pricing |
|---|---|---|
| Nansen | Smart Money tracking, whale data | Free tier / $49/mo |
| BlockRun | AI models, X/Twitter data | Pay-per-request |
| Dune | Custom SQL analytics | Free tier |
# Example: Add Nansen for on-chain data
claude mcp add --transport http nansen https://mcp.nansen.ai/ra/mcp \
--header "NANSEN-API-KEY: YOUR_KEY"
Related
- @blockrun/mcp - AI model access
- alpha-trader - Claude Code trading agent
License
MIT
Tools (8)
alpha_signalTechnical analysis (RSI, MACD, EMA) via CoinGeckoalpha_dexDEX market data via DexScreeneralpha_sentimentSocial sentiment analysis (requires BlockRun wallet)alpha_swapToken swap quotes + execution on Basealpha_portfolioPosition tracking and managementalpha_memoryVector-based trade memory searchalpha_riskRisk management checksalpha_extensionsDiscover additional MCPs (Nansen, Dune, etc.)Environment Variables
ONEINCH_API_KEY1inch API key for best ratesZEROX_API_KEY0x API key as alternativeConfiguration
claude_desktop_config.json
{
"mcpServers": {
"alpha": {
"command": "npx",
"args": ["-y", "@blockrun/alpha"],
"env": {
"ONEINCH_API_KEY": "",
"ZEROX_API_KEY": ""
}
}
}
}Try it
→Get ETH technical signals
→Check PEPE market data
→Find similar trades to ETH breakout
→Check if $500 ETH buy passes risk limits
→Swap 100 USDC for ETH