Skip to content

Marcus-Rug-Intel/rug-munch-mcp

Repository files navigation

🛡️ Marcus Rug Intel — MCP Server

MCP PyPI Tools x402 Free Tier Smithery Glama Coinbase x402 Ecosystem

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

Tool What Price
check_token_risk Quick risk score (0-100) + recommendation Free (1/day) or $0.04
check_token_risk_premium Full breakdown + deployer + social OSINT $0.10
check_batch_risk Up to 20 tokens at once $0.30
check_deployer_history Deployer wallet analysis — serial rugger? $0.06
get_token_intelligence Complete token profile (price, holders, LP) $0.06
get_holder_deepdive Top holders, concentration, sniper detection $0.10
get_social_osint Social media presence and red flags $0.06
get_kol_shills KOL/influencer shill detection $0.06
get_coordinated_buys Detect coordinated buying patterns $0.04
check_blacklist Community blacklist check $0.02
check_scammer_wallet Known scammer wallet check $0.02
get_market_risk_index Global market risk overview $0.02
get_serial_ruggers Known serial rugger wallets $0.02
marcus_quick AI verdict — Claude Sonnet 4 quick analysis $0.15
marcus_forensics AI forensics — full Claude Sonnet 4 investigation $0.50
marcus_ultra AI deep analysis — Claude Opus 4 $2.00
marcus_thread AI analysis thread for X/Twitter $1.00
watch_token 7-day webhook monitoring for risk changes $0.20
get_api_status Service health + accuracy metrics Free

💳 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

Registry Link
Official MCP Registry io.github.amarodeabreu/rug-munch-mcp
PyPI pip install rug-munch-mcp
Smithery rug-munch-intelligence
Glama rug-munch-intelligence
x402 Bazaar cryptorugmunch.app
A2A Agent Card /.well-known/agent.json
awesome-x402 PR #28 merged

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

About

MCP server for Marcus Rug Intel — 19 tools for crypto token risk analysis, rug pull detection, and AI forensics. Works with Claude Desktop, Cursor, Windsurf.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages