# @blockrun/alpha
AI-powered crypto trading MCP server with technical analysis, sentiment, and execution tools.
## Installation
```bash
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)
- **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 |
```bash
# 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](https://github.com/blockrunai/blockrun-mcp) - AI model access
- [alpha-trader](https://github.com/blockrunai/alpha-trader) - Claude Code trading agent
## License
MIT
