# Rug Munch Intelligence — MCP Server
<!-- mcp-name: io.github.amarodeabreu/rug-munch-mcp -->
[](https://modelcontextprotocol.io)
[](https://cryptorugmunch.app/api/agent/v1/status)
[](https://cryptorugmunch.app/.well-known/x402)
**19 tools for crypto token risk intelligence.** Detect rug pulls, honeypots, and scams before your agent transacts.
Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.
## What It Does
| Tool | What | Price |
|------|------|-------|
| `check_token_risk` | Quick risk score (0-100) + recommendation | $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) | Free |
## Quick Start
### Install
```bash
pip install rug-munch-mcp
```
### Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"rug-munch": {
"command": "rug-munch-mcp",
"env": {}
}
}
}
```
### Cursor / Windsurf
Add to your MCP config:
```json
{
"rug-munch": {
"command": "python3",
"args": ["-m", "rug_munch_mcp"]
}
}
```
### From Source
```bash
git clone https://github.com/CryptoRugMunch/rug-munch-mcp
cd rug-munch-mcp
pip install -e .
rug-munch-mcp
```
## Payment
Endpoints are paid via **x402 USDC micropayments** on Base mainnet. When you call a paid tool, the API returns HTTP 402 with payment details. x402-compatible clients handle this automatically.
Alternatively, set an API key to bypass x402:
```json
{
"mcpServers": {
"rug-munch": {
"command": "rug-munch-mcp",
"env": {
"RUG_MUNCH_API_KEY": "your-key-here"
}
}
}
}
```
## Supported Chains
Solana, Ethereum, Base, Arbitrum, Polygon, Optimism, Avalanche
## Architecture
```
Your Agent (Claude, Cursor, etc.)
↓ MCP stdio
rug-munch-mcp (this package)
↓ HTTPS
cryptorugmunch.app/api/agent/v1/*
↓ x402 payment (if needed)
Rug Munch Intelligence API
↓
240K+ scans, 114K+ flagged tokens, AI forensics
```
## Other Integration Methods
- **x402 Direct**: [x402-trading-agent](https://github.com/CryptoRugMunch/x402-trading-agent) — Example Python agent
- **AgentKit Plugin**: [rug-agent-kit](https://github.com/CryptoRugMunch/rug-agent-kit) — Coinbase AgentKit integration
- **A2A**: `https://cryptorugmunch.app/.well-known/agent.json`
- **OpenAPI**: `https://cryptorugmunch.app/api/agent/v1/openapi.json`
## Links
- **API Status**: https://cryptorugmunch.app/api/agent/v1/status
- **Discovery**: https://cryptorugmunch.app/.well-known/mcp.json
- **Docs**: https://cryptorugmunch.app/api/agent/v1/skill.md
- **GitHub**: https://github.com/CryptoRugMunch
## License
MIT
