Metadata-Version: 2.4
Name: rug-munch-mcp
Version: 1.0.0
Summary: MCP server for Rug Munch Intelligence — 19 tools for crypto token risk analysis, rug pull detection, and AI forensics
Author-email: CryptoRugMunch <dev@cryptorugmunch.app>
License: MIT
Project-URL: Homepage, https://cryptorugmunch.app
Project-URL: Repository, https://github.com/CryptoRugMunch/rug-munch-mcp
Project-URL: Documentation, https://cryptorugmunch.app/api/agent/v1/skill.md
Project-URL: API Status, https://cryptorugmunch.app/api/agent/v1/status
Project-URL: x402 Discovery, https://cryptorugmunch.app/.well-known/x402
Keywords: mcp,crypto,security,rug-pull,ai-agent,x402,token-risk
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Security
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.0.0
Requires-Dist: httpx>=0.25.0
Dynamic: license-file

# Rug Munch Intelligence — MCP Server

[![MCP](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io)
[![Tools](https://img.shields.io/badge/tools-19-green)](https://cryptorugmunch.app/api/agent/v1/status)
[![x402](https://img.shields.io/badge/x402-USDC-purple)](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
