rugmuncher-backend / docs /MCP-README.md

cryptorugmunch

merge: chore/cleanup-remove-bloat-and-secrets into main

bde2f3a about 2 months ago

preview code

Raw

History Blame Contribute Delete

9.62 kB

Rug Munch Intelligence — MCP Server Documentation

210 crypto intelligence tools · 13 blockchains · x402 micropayments · Free trials

Overview

Rug Munch Intelligence (RMI) is a crypto security and market intelligence MCP server. It provides 210 tools across 13 blockchains for scam detection, rug pull prevention, wallet forensics, whale tracking, contract auditing, and market analysis — accessible via the Model Context Protocol.

Every tool offers 1–5 free trial calls (gated by device fingerprint) and x402 micropayments ($0.01–$0.40/call) via 8 payment facilitators across 13 chains.

Architecture

┌─────────────────────────────────────────────────────────┐
│  AI Agent (Claude, Cursor, GPT, Windsurf, etc.)       │
│  Uses MCP protocol to discover and call tools          │
└───────────────────────┬─────────────────────────────────┘
                        │ MCP (HTTP/SSE)
                        ▼
┌─────────────────────────────────────────────────────────┐
│  rugmunch.io/mcp                                       │
│  MCP Server — 210 tools, schema discovery              │
├─────────────────────────────────────────────────────────┤
│  x402 Payment Gatekeeper                               │
│  Trial enforcement → Payment required → 402 response  │
│  8 facilitators × 13 chains × USDC/USDT/BTC/EUR       │
├─────────────────────────────────────────────────────────┤
│  FastAPI Backend — 80+ modules                         │
│  Security · Intelligence · Market · Social · Forensics │
├─────────────────────────────────────────────────────────┤
│  Data Layer                                             │
│  DexScreener · CoinGecko · Helius · Birdeye · Jupiter  │
│  Etherscan · Moralis · DefiLlama · 28 providers        │
└─────────────────────────────────────────────────────────┘

Quick Start

Claude Desktop

{
  "mcpServers": {
    "rug-munch-intelligence": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://rugmunch.io/mcp"],
      "env": {}
    }
  }
}

Cursor / Windsurf

{
  "mcpServers": {
    "rug-munch-intelligence": {
      "url": "https://rugmunch.io/mcp",
      "transport": "http"
    }
  }
}

Raw HTTP (cURL)

# Discover available tools
curl https://rugmunch.io/api/v1/x402-tools/discovery

# Call a tool (free trial — no payment needed)
curl -X POST https://rugmunch.io/api/v1/x402-tools/rugshield \
  -H "Content-Type: application/json" \
  -H "X-Client-ID: my-fingerprint-id" \
  -d '{"address": "So11111111111111111111111111111111111111112", "chain": "solana"}'

# Call a paid tool (with x402 payment)
curl -X POST https://rugmunch.io/api/v1/x402-tools/audit \
  -H "Content-Type: application/json" \
  -H "x-pay: <x402-payment-header>" \
  -d '{"address": "0x...", "chain": "ethereum"}'

Python

import requests

# Discover
tools = requests.get("https://rugmunch.io/api/v1/x402-tools/discovery").json()
print(f"{tools['total_tools']} tools available")

# Free trial call
result = requests.post(
    "https://rugmunch.io/api/v1/x402-tools/rugshield",
    headers={"X-Client-ID": "my-app"},
    json={"address": "So11111111111111111111111111111111111111112", "chain": "solana"}
).json()

Tool Categories

Category	Count	Highlight Tools
🔒 Security	29 + 9 SENTINEL	`audit`, `rugshield`, `honeypot_check`, `sentinel_scan`, `holder_analysis`, `flash_loan_detect`, `governance_attack`
🧠 Intelligence	27	`smartmoney`, `whale_scan`, `cluster`, `insider`, `cross_chain_whale`, `degen_score`, `wallet_label_registry`
📊 Market	15	`pulse`, `market_overview`, `chain_health`, `funding_rate`, `options_flow`, `liquidation_heatmap`, `volatility_surface`
🔬 Analysis	14	`wallet`, `wallet_pnl`, `portfolio_tracker`, `forensics`, `correlation_matrix`, `drawdown_analyzer`, `volume_profile`
💬 Social	11	`sentiment`, `social_signal`, `tw_profile`, `meme_vibe_score`, `telegram_pump_detect`, `discord_alpha`, `reddit_sentiment`
🚀 Launch	7	`launch`, `launch_intel`, `airdrop_finder`, `presale_scanner`, `ido_tracker`, `fair_launch_detect`
🔎 Premium	7	`forensic_valuation`, `osint_identity_hunt`, `deep_forensics`, `whale_network_map`, `cross_chain_trace`, `full_wallet_dossier`
💎 DeFi	4	`defi_yield_scanner`, `yield_aggregator`, `impermanent_loss`, `protocol_risk`
🖼 NFT	2	`nft_wash_detector`, `nft_floor_analytics`
📦 Bundle	4	`security_pack`, `intelligence_pack`, `all_in_one`, `forensic_pack`
🔌 API	3	`catalog`, `mcp-proxy`, `human-execute`
🔄 Variant	80	Per-chain variants for Solana, Base, Ethereum, BSC

Total: 210 tools

Supported Blockchains

Chain	Chain ID	USDC	USDT	BTC	EUR
Base	8453	✅	—	—	—
Solana	—	✅	—	—	—
Ethereum	1	✅	—	—	—
BSC	56	✅	✅	—	—
Arbitrum	42161	✅	—	—	—
Optimism	10	✅	—	—	—
Polygon	137	✅	—	—	—
Avalanche	43114	✅	—	—	—
Fantom	250	✅	—	—	—
Gnosis	100	✅	—	—	—
TRON	—	✅	✅	—	—
Bitcoin	—	—	—	✅	—
SEPA (EUR)	—	—	—	—	✅

Payment Facilitators

Facilitator	Chains	Asset	Fee	Description
Coinbase CDP	Base, Solana	USDC	Free	Fee-free via Coinbase Developer Platform
PayAI	Base, Solana	USDC	Variable	Deferred settlement
Cloudflare x402	Base Sepolia, Ethereum	USDC	Low	Cloudflare-managed facilitation
EIP-7702	BSC, Polygon, Avalanche, Fantom, Gnosis, Arbitrum, Optimism, Base	USDC	Low	Universal EVM via EIP-7702 authorization
TRON Self-Verify	TRON	USDT/USDC/USDD	Free	Self-verified via TronGrid API
Bitcoin Self-Verify	Bitcoin	BTC	Free	Self-verified via Mempool.space (1-conf)
AsterPay	SEPA	EUR	Variable	European bank transfer
x402-rs	Multi-chain	USDC	Low	Self-hosted x402-rs Docker

Pricing & Trials

Tier	Cost	Description
Free Trial	$0	1–5 calls per tool. Device fingerprint-gated. No wallet needed.
Wallet Connected	$0	Connect wallet for 3 free calls per standard tool, 1 per premium.
Pay Per Call	$0.01–$0.40	x402 micropayment per call. Auto-handled by MCP client.

Refund Policy

Full refund if a tool returns no data
Request within 48 hours via POST /api/v1/x402/refund with transaction hash
No questions asked on empty-result refunds

Authentication Hierarchy

No auth → Trial mode (1–5 free calls, fingerprint-gated)
Wallet signature → Extended trials (3 per tool, wallet-gated)
x402 payment → Full access (micropayment per call)
API key → Subscription access (coming soon)

Error Handling

HTTP Code	Meaning	Action
200	Success	Use response data
402	Payment Required	Send x402 payment header and retry
429	Rate Limited	Wait and retry with backoff
404	Tool Not Found	Check tool ID via `/discovery`
500	Server Error	Retry after brief delay

Rate Limits

Trial users: 60 requests/hour per fingerprint
Paid users: 300 requests/hour per wallet
Enterprise: Custom limits — contact mcp@rugmunch.io

Links & Resources

Resource	URL
Website	https://rugmunch.io
Documentation	https://rugmunch.io/docs/mcp
MCP Endpoint	https://rugmunch.io/mcp
Discovery	https://rugmunch.io/.well-known/mcp.json
x402 Discovery	https://rugmunch.io/.well-known/x402
GitHub	https://github.com/Rug-Munch-Media-LLC/rug-munch-intelligence-mcp
Smithery	https://smithery.ai/server/@cryptorugmuncher/rug-munch-intelligence
Glama	https://glama.ai/mcp/servers/@cryptorugmuncher/rug-munch-intelligence

cryptorugmunch
/

rugmuncher-backend