rugmuncher-backend / docs /MCP-README.md

Crypto Rug Muncher

clean slate: removing all old data, fresh build

6993919 2 months ago

9.62 kB

	# Rug Munch Intelligence — MCP Server Documentation

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

	[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-6E40C9?logo=modelcontextprotocol&logoColor=white)](https://modelcontextprotocol.io)
	[![Smithery](https://img.shields.io/badge/Listed-Smithery-FF6900)](https://smithery.ai/server/@cryptorugmuncher/rug-munch-intelligence)
	[![Glama](https://img.shields.io/badge/Listed-Glama-7C3AED)](https://glama.ai/mcp/servers/@cryptorugmuncher/rug-munch-intelligence)

	---

	## 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

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

	### Cursor / Windsurf

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

	### Raw HTTP (cURL)

	```bash
	# 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

	```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

	1. No auth → Trial mode (1–5 free calls, fingerprint-gated)
	2. Wallet signature → Extended trials (3 per tool, wallet-gated)
	3. x402 payment → Full access (micropayment per call)
	4. 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 \|

	---

	## License

	Proprietary — © 2024–2026 Rug Munch Media LLC. All rights reserved.