@blockrun/alpha

@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)
• 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