231 lines
9.4 KiB
Markdown
231 lines
9.4 KiB
Markdown
# Rug Munch Intelligence — MCP Server Documentation
|
||
|
||
> **210 crypto intelligence tools · 13 blockchains · x402 micropayments · Free trials**
|
||
|
||
[](https://modelcontextprotocol.io)
|
||
[](https://smithery.ai/server/@cryptorugmuncher/rug-munch-intelligence)
|
||
[](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.
|