RugBurn MCP Server

Read-only Model Context Protocol server for RugBurn API v1. Gives Claude and any MCP-compatible agent runtime direct access to RugBurn token screening, deployer history, and pre-trade decisions.

Install

npx @rugburn/mcp

No clone needed. Requires a rbn_live_ API key from your RugBurn dashboard.

Claude Code Setup

claude mcp add rugburn \
  -s user \
  -e RUGBURN_API_BASE_URL=https://rugburn.io \
  -e RUGBURN_API_KEY=rbn_live_... \
  -- npx @rugburn/mcp

Claude Desktop / Other Clients

{
  "mcpServers": {
    "rugburn": {
      "command": "npx",
      "args": ["@rugburn/mcp"],
      "env": {
        "RUGBURN_API_BASE_URL": "https://rugburn.io",
        "RUGBURN_API_KEY": "${RUGBURN_API_KEY}"
      }
    }
  }
}

Tools

| Tool | Description | |---|---| | screen_token | Latest cached token-risk report for a Solana mint | | screen_wallet | Wallet-risk screening for a Solana wallet | | explain_score | Compact explanation of a token or wallet score | | get_deployer_history | RugBurn-observed deployer launch history | | pre_trade_check | Pre-trade go/no-go decision with invalidation rules | | monitor_position | Active-position hold/exit signal with pressure signals | | smart_money_atlas | Top traders by realized edge (Dune-cached leaderboard) | | cohort_traversal | Deployer cohort graph — edge-resolved fresh-wallet rotation + Dune reputation | | launchpad_classify | Real deployer vs launchpad authority PDA (e.g. pump.fun) |

pre_trade_check and monitor_position require a Pro or Whale API key.

Streamable HTTP transport (v2)

Beyond stdio, the server runs as a Streamable HTTP endpoint so agents receive pushed events over an open connection instead of polling:

RUGBURN_API_BASE_URL=https://rugburn.io \
RUGBURN_MCP_HTTP_PORT=8787 \
RUGBURN_MCP_PUSH_SECRET=<shared-secret> \
  rugburn-mcp-http

• POST / — JSON-RPC; the agent's key is read from Authorization: Bearer.
• GET / — opens a text/event-stream (keyed by Mcp-Session-Id) the server pushes notifications down, with heartbeats.
• POST /push — a trusted producer (worker/cron) posts an invalidation event here with X-RugBurn-Push-Secret; it is broadcast to every open session as an MCP notifications/message. This is the seam the live event source plugs into.

Environment

RUGBURN_API_BASE_URL=https://rugburn.io   # optional, defaults to rugburn.io
RUGBURN_API_KEY=rbn_live_...              # required
RUGBURN_MCP_TIMEOUT_MS=20000             # optional, default 20s

Never configure this package with Supabase keys, Helius keys, service-role credentials, or worker secrets.

Boundary

RugBurn MCP returns risk-screening evidence for agent reasoning. It is not financial advice and is not a legal compliance determination.