RugBurn - Solana Risk Intelligence

Availability

The MCP server is 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/mcp

Live

Clone + run

Live

Remote / hosted

Roadmap

Claude Code (Recommended)

Add RugBurn to Claude Code with one command. Requires a rbn_live_ API key from your dashboard.

bash

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.mjs

Once connected, Claude can call any of the tools below directly. Example prompts:

text

"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

json

{  "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 Token

Read the same cached token-risk packet through MCP when your agent runs locally over stdio.

screen_wallet

Screen Wallet

Forward wallet screening into the same public API contract instead of hiding a separate backend path.

explain_score

Explain Score

Return a short textual explanation plus the raw API payload so the model can reason and the operator can verify.

get_deployer_history

Get Deployer History

Let an agent inspect recurring deployer behavior with the same public evidence contract used by dashboards and bots.

pre_trade_checkPro / Whale

Pre-Trade Check

Gate 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_positionPro / Whale

Monitor Position

Check 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

MCP toolscreen_tokenmirrors POST /api/v1/token/risk

Read the same cached token-risk packet through MCP when your agent runs locally over stdio.

MCP tool call

json

{  "jsonrpc": "2.0",  "id": 8,  "method": "tools/call",  "params": {    "name": "screen_token",    "arguments": {      "address": "So11111111111111111111111111111111111111112"    }  }}

MCP tool result

json

{  "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"  }}

Equivalent API request

curl

curl https://rugburn.io/api/v1/token/risk \  -H "Authorization: Bearer $RUGBURN_API_KEY" \  -H "Content-Type: application/json" \  -d '{"address":"So11111111111111111111111111111111111111112"}'

Equivalent API response

json

{  "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

bash

RUGBURN_API_BASE_URL=https://rugburn.io   # requiredRUGBURN_API_KEY=rbn_live_...              # required — dashboard API keyRUGBURN_MCP_TIMEOUT_MS=20000             # optional, default 20s

The 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.