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

 
 
 

Contributors

Languages