MCP Server
A read-only stdio MCP server that gives Claude and any MCP-compatible agent runtime direct access to RugBurn token screening, deployer history, and pre-trade decisions — using your dashboard API key.
Availability
Published on npm. No clone needed — just an API key from your dashboard and one command. A hosted remote option (no local install at all) is on the roadmap.
- npx @rugburn/mcpLive
- Clone + runLive
- Remote / hostedRoadmap
Claude Code (Recommended)
Add RugBurn to Claude Code with one command. Requires a rbn_live_ API key from your dashboard.
claude mcp add rugburn \ -s user \ -e RUGBURN_API_BASE_URL=https://rugburn.io \ -e RUGBURN_API_KEY=rbn_live_... \ -- node /path/to/rugburn-mcp/src/server.mjsOnce connected, Claude can call any of the tools below directly. Example prompts:
"Pre-trade check on <mint> — momentum scalp, 5m horizon""Screen this wallet before I interact with it: <address>""Check the deployer history for <wallet> — how many honeypots?"Claude Desktop / Other Clients
{ "mcpServers": { "rugburn": { "command": "node", "args": ["/path/to/rugburn-mcp/src/server.mjs"], "env": { "RUGBURN_API_BASE_URL": "https://rugburn.io", "RUGBURN_API_KEY": "${RUGBURN_API_KEY}" } } }}Windows users: use the full path to node.exe and forward slashes in all paths. See the Claude Code setup above for the exact pattern.
Tool Map
- Screen Token
screen_tokenRead the same cached token-risk packet through MCP when your agent runs locally over stdio.
- Screen Wallet
screen_walletForward wallet screening into the same public API contract instead of hiding a separate backend path.
- Explain Score
explain_scoreReturn a short textual explanation plus the raw API payload so the model can reason and the operator can verify.
- Get Deployer History
get_deployer_historyLet an agent inspect recurring deployer behavior with the same public evidence contract used by dashboards and bots.
- Pre-Trade Check
Pro / WhaleGate a trade before entry. Returns a go/no-go decision, confidence score, and invalidation rules based on cached RugBurn evidence. Call this before buying any token.
- Monitor Position
Pro / WhaleCheck whether an open position should be held or exited. Returns pressure signals, confidence, and next-check interval based on cached evidence. Call this periodically while in a position.
Request / Response Contract
Test a tool call and see the equivalent API request side by side.
screen_tokenmirrors POST /api/v1/token/riskRead the same cached token-risk packet through MCP when your agent runs locally over stdio.
{ "jsonrpc": "2.0", "id": 8, "method": "tools/call", "params": { "name": "screen_token", "arguments": { "address": "So11111111111111111111111111111111111111112" } }}{ "data": { "address": "So11111111111111111111111111111111111111112", "name": "Wrapped SOL", "symbol": "SOL", "safetyScore": 61, "riskScore": 39, "riskLevel": "medium", "recommendedAction": "monitor", "summary": "Cached RugBurn evidence shows liquid trading, but ownership concentration still needs review.", "modelVersion": "score-v3.3-shadow", "confidence": { "label": "high", "score": 79 }, "facets": { "contract": 86, "liquidity": 74, "ownership": 48, "deployer": 69, "market": 63, "maturity": 58, "metadata": 80, "aml": 50 }, "hardCaps": [ "Top 10 Holder Cap:58" ], "risks": [ "High concentration: top 10 holders own 58.4%", "Creator ownership evidence needs continued monitoring" ], "market": { "liquidityUsd": 214320, "marketCap": 1184300, "volume24h": 392100, "priceChange5m": -1.7, "priceChange1h": 4.2, "priceChange6h": 12.4, "priceChange24h": 19.1, "buyCount24h": 1182, "sellCount24h": 903, "tradeCount24h": 2085 }, "evidence": { "isHoneypot": false, "lpLocked": true, "lpLockPercentage": 92, "buyTax": 0, "sellTax": 0, "top10HolderPct": 58.4, "deployerAddress": "Vote111111111111111111111111111111111111111", "scanSource": "cached_scan", "scannedAt": "2026-04-23T11:58:04.000Z" }, "scoreBreakdown": [ { "name": "holder_distribution", "points": -16, "reason": "Top-10 concentration remains elevated for public entry." }, { "name": "lp_lock", "points": 8, "reason": "Liquidity lock evidence is present." } ], "sources": [ "rugburn_token_scans", "rugburn_scoring_engine" ] }, "meta": { "requestId": "req_demo_token_risk_01", "scope": "token:risk:read", "quota": { "limit": 5000, "used": 41, "remaining": 4959 }, "generatedAt": "2026-04-23T12:00:00.000Z", "cacheMode": "latest_cached_scan", "contractVersion": "2026-04-16" }}curl https://rugburn.io/api/v1/token/risk \ -H "Authorization: Bearer $RUGBURN_API_KEY" \ -H "Content-Type: application/json" \ -d '{"address":"So11111111111111111111111111111111111111112"}'{ "data": { "address": "So11111111111111111111111111111111111111112", "name": "Wrapped SOL", "symbol": "SOL", "safetyScore": 61, "riskScore": 39, "riskLevel": "medium", "recommendedAction": "monitor", "summary": "Cached RugBurn evidence shows liquid trading, but ownership concentration still needs review.", "modelVersion": "score-v3.3-shadow", "confidence": { "label": "high", "score": 79 }, "facets": { "contract": 86, "liquidity": 74, "ownership": 48, "deployer": 69, "market": 63, "maturity": 58, "metadata": 80, "aml": 50 }, "hardCaps": [ "Top 10 Holder Cap:58" ], "risks": [ "High concentration: top 10 holders own 58.4%", "Creator ownership evidence needs continued monitoring" ], "market": { "liquidityUsd": 214320, "marketCap": 1184300, "volume24h": 392100, "priceChange5m": -1.7, "priceChange1h": 4.2, "priceChange6h": 12.4, "priceChange24h": 19.1, "buyCount24h": 1182, "sellCount24h": 903, "tradeCount24h": 2085 }, "evidence": { "isHoneypot": false, "lpLocked": true, "lpLockPercentage": 92, "buyTax": 0, "sellTax": 0, "top10HolderPct": 58.4, "deployerAddress": "Vote111111111111111111111111111111111111111", "scanSource": "cached_scan", "scannedAt": "2026-04-23T11:58:04.000Z" }, "scoreBreakdown": [ { "name": "holder_distribution", "points": -16, "reason": "Top-10 concentration remains elevated for public entry." }, { "name": "lp_lock", "points": 8, "reason": "Liquidity lock evidence is present." } ], "sources": [ "rugburn_token_scans", "rugburn_scoring_engine" ] }, "meta": { "requestId": "req_demo_token_risk_01", "scope": "token:risk:read", "quota": { "limit": 5000, "used": 41, "remaining": 4959 }, "generatedAt": "2026-04-23T12:00:00.000Z", "cacheMode": "latest_cached_scan", "contractVersion": "2026-04-16" }}Environment Variables
RUGBURN_API_BASE_URL=https://rugburn.io # requiredRUGBURN_API_KEY=rbn_live_... # required — dashboard API keyRUGBURN_MCP_TIMEOUT_MS=20000 # optional, default 20sThe MCP server only needs your dashboard API key. It never requires Supabase credentials, Helius keys, or any worker-only secrets.
Safety Boundary
MCP returns RugBurn screening evidence for local agent reasoning. It is not financial advice, not a legal compliance determination, and not permission for an agent to trade, block users, or make irreversible decisions without operator review.
