io.github.amarodeabreu/rug-munch-mcp

🛡️ Marcus Rug Intel — MCP Server

73% of new crypto tokens are scams or honeypots. This MCP server lets your AI agent check any token before transacting — the cheapest insurance in crypto.

19 tools for rug pull detection, honeypot scoring, deployer tracking, holder deep-dive, KOL shill detection, social OSINT, and LLM forensic analysis (Claude Sonnet 4 / Opus 4).

⚡ Try It Right Now (Free)

No install needed. 1 free call/day, no auth:

curl -X POST https://cryptorugmunch.app/api/agent/v1/check-risk \
  -H "Content-Type: application/json" \
  -d '{"token_address": "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr"}'

Response:

{
  "token_address": "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr",
  "risk_score": 85,
  "risk_level": "critical",
  "recommendation": "AVOID",
  "honeypot_risk": true,
  "freeze_authority": true,
  "token_name": "SuspiciousToken",
  "token_symbol": "SCAM"
}

🚀 Quick Start

Option 1: Install via pip

pip install rug-munch-mcp

Option 2: Remote SSE (no install)

Connect directly to our hosted server:

https://cryptorugmunch.app/mcp/sse

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "rug-munch": {
      "command": "rug-munch-mcp",
      "env": {}
    }
  }
}

Cursor / Windsurf / VS Code

{
  "mcpServers": {
    "rug-munch": {
      "command": "rug-munch-mcp",
      "env": {}
    }
  }
}

OpenClaw

mcporter config add rug-munch --command "rug-munch-mcp"
mcporter call rug-munch.check_token_risk token_address=<MINT>

🔧 All 19 Tools

💳 Authentication Options

Free Tier (recommended to start)

• 10 calls/day on check_token_risk — no auth needed
• Just send the request, we'll answer

API Key (1,000 calls/hr)

# Get a key instantly (free, anonymous)
curl -X POST https://cryptorugmunch.app/api/agent/v1/keys/request \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

# Use it on ALL 19 endpoints
curl -X POST https://cryptorugmunch.app/api/agent/v1/check-batch \
  -H "Content-Type: application/json" \
  -H "X-API-Key: mri_your_key_here" \
  -d '{"tokens": ["token1", "token2", "token3"]}'

x402 USDC Micropayments

Pay per-call with USDC on Base or Solana. See x402 docs.

Compatible with x402-fetch, x402-axios, Coinbase AgentKit, and any x402-enabled client.

🌐 Where We're Listed

📡 Discovery Endpoints (Free)

# Service status & accuracy metrics
curl https://cryptorugmunch.app/api/agent/v1/status

# OpenAPI spec
curl https://cryptorugmunch.app/api/agent/v1/openapi.json

# Human-readable skill description
curl https://cryptorugmunch.app/api/agent/v1/skill.md

# x402 payment details
curl https://cryptorugmunch.app/.well-known/x402

# A2A agent card
curl https://cryptorugmunch.app/.well-known/agent.json

# MCP server info
curl https://cryptorugmunch.app/.well-known/mcp.json

🤖 For Agent Developers

Reference Trading Agent

Full Python example agent that uses x402 to check tokens before trading: → CryptoRugMunch/x402-trading-agent

Coinbase AgentKit Plugin

Drop-in plugin for AgentKit-powered agents: → CryptoRugMunch/rug-agent-kit

🏗️ Architecture

Your Agent
    │
    ├── pip install rug-munch-mcp  (local STDIO)
    │   └── Talks to cryptorugmunch.app API
    │
    ├── SSE: cryptorugmunch.app/mcp/sse  (remote, no install)
    │
    └── Direct HTTP: cryptorugmunch.app/api/agent/v1/*
        ├── Free tier (1/day, no auth)
        ├── API key (1000/hr, X-API-Key header)
        └── x402 USDC (Payment-Signature header)

📊 Trust & Transparency

• Trust score: Published at /api/agent/v1/status
• Detection accuracy: 91%+ on known rug pulls
• Uptime: 99.9%+ (monitored)
• Response time: <500ms for cached, <5s for fresh scans
• Feedback loop: POST /api/agent/v1/feedback — report false positives

License

MIT

⚠️ Note: This project was formerly known as CryptoRugMunch. The $CRM token is not affiliated with Marcus Rug Intel. We operate on a Stars-based subscription model — no token required.

Built by Marcus Rug Intel — the cheapest insurance in crypto.