Hugging Face's logo

cryptorugmuncher
/
rugmuncher-backend

Model card Files
xet
 Community
rugmuncher-backend / backend /README.md
Netcup Server
ops: commit netcup-specific docs, config, and M3 Bayesian reputation on netcup mainline
846b6be
preview code
|
Raw
History Blame Contribute Delete
12.1 kB

Rug Munch Intelligence — Platform Documentation

The Bloomberg Terminal of Shitcoins

Rug Munch Intelligence (RMI) is a unified crypto intelligence platform providing 270+ tools for token security, wallet forensics, whale tracking, market data, and blockchain queries. Every data call routes through our DataBus pipeline — 38 data chains, 67 providers, automatic failover, multi-layer caching.

Access: https://mcp.rugmunch.io | Docs: https://rugmunch.io/docs | Operations: @rmialerts (Telegram)

v3 Architecture (Jun 21 2026)

The backend was rebuilt via strangler-fig pattern during Jun 21 crisis ops. The legacy 8,475-line _legacy_main.py is preserved but no longer imported. The new clean main.py (243 lines) mounts v1 routers exclusively.

Frozen files (do not edit without explicit un-freeze):

  • main.py, _legacy_main.py, app/core/redis.py, app/core/config.py, app/databus/core.py, app/rag/pipeline.py, app/crypto_embeddings.py, app/api/v1/__init__.py, docker-compose.yml, app/core/tracing.py, app/agents/loop.py, app/mcp/server.py, app/core/metrics.py, app/middleware/cost_tracking.py

AI-Forward Modules (M1-M8) — 8 mandated modules shipping through Jun:

  • M1 Risk Explainer · M2 News Classifier · M3 Sentiment Stream
  • M4 On-chain Detective · M5 Threat Modeler · M6 Cost Optimizer
  • M7 SLO + Error Budgets · M8 Self-Healing Loops

Telegram channel surface (rugmunchbot has admin on all):

  • @cryptorugmuncher (main) · @rmicryptonews (news)
  • @rmiupdates (changelog) · @rmialerts (operations — wired to AlertManager)
  • @rmialpha (intel) · @rmiscans (scan feed)

Observability stack:

  • Prometheus on 172.19.0.8:9090, scrapes rmi-backend at 172.19.0.3:8000
  • 11 alert rules across rmi-backend-critical, rmi-infra-warning, rmi-slo-burn
  • AlertManager on host:9095, routes to @rmialerts via rugmunchbot
  • /api/v1/admin/alerts/{webhook,critical,recent} — in-app alert history

Quick Start 

# Discover the platform
curl https://mcp.rugmunch.io/.well-known/mcp

# List all tools
curl https://mcp.rugmunch.io/mcp/tools

# Check platform health
curl https://mcp.rugmunch.io/mcp/health

# Get SDK examples
curl https://mcp.rugmunch.io/mcp/sdk

MCP Native (Claude Desktop, Cursor, Windsurf):

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

Platform Capabilities

Tool Categories (234+ total, growing — check /mcp/status for live count)

Category Count Description
Security Scanning 45 Rug pulls, honeypots, audits, clone detection, MEV protection
Wallet Intelligence 38 PnL, clustering, insider networks, whale tracking, forensics
Market Data 32 Prices, liquidity, volume, arbitrage, trends, OHLCV
Token Analytics 28 Holder distribution, sniper detection, deployer history
DeFi Analytics 24 TVL, yields, protocol risk, liquidity flow, bridges
Social Signals 18 Sentiment, KOL tracking, profile flips, meme scoring
Caching Shield 13 Internal multi-provider data access layer
Local MCP 85 Self-hosted Solana RPC (60) + EVM (25 tools, 86 networks)
Free Public MCP 50 Boar blockchain (ETH, ENS, contracts, keyless)

Supported Chains (96+ via DataBus, 13 native + 86 EVM via local MCP)

DataBus is the single source of truth: 96 chains, 119 providers, automatic failover. See app/databus/core.py and app/api/v1/public/databus/ for the live surface.

Payment Facilitators (8 — plus x402 MCP marketplace gateway)

Coinbase CDP, EIP-7702 Universal EVM, Cloudflare x402, PayAI, Asterpay (SEPA), TRON Self-Verify, Bitcoin Self-Verify, PrimeV. The x402 MCP marketplace gateway (x402-mcp-gateway skill) handles tool-level micropayments in USDC on Base.

Pricing & Access

Free Trials

Every paid tool includes 1-5 free trial calls. No payment required until trials exhausted. Fingerprint-gated anti-abuse. Monthly reset.

Individual Tools

$0.01 - $0.40 per call. Pay only for what you use. Full automatic refund within 48 hours if tool returns no data.

Scan Packs (50-53% off)

Pack Tools Price
Token Hunter Pack Fresh pairs, snipers, security, deployer, clone detection $0.09
Whale Watcher Suite Whale scan, accumulation, smart money, syndicates, PnL $0.14
Wallet Forensics Funding trace, insider network, wash trading, wallet graph $0.17
Market Pulse Prices, liquidity, arbitrage, sentiment, listings $0.12

Membership Tiers (60-90% discount)

Tier Price/mo Daily Calls Best For
Scout $4.99 50 Casual traders, hobby agents
Hunter $14.99 200 Active traders, alpha groups
Whale $49.99 1,000 Professional funds, market makers
Institution $199.99 5,000 Enterprises, high-frequency agents

Streaming Feeds

Real-time data via WebSocket + webhook delivery:

  • New Token Firehose ($0.50/hr) — Every new token across all chains
  • Whale Alert Stream ($0.75/hr) — Large transfers, positions, accumulation
  • Multi-Chain Price Feed ($0.30/hr) — OHLCV, volume, arbitrage
  • Security Alert Feed ($0.60/hr) — Rug pulls, exploits, suspicious activity

Deep Research Reports

  • Token Deep Dive ($0.75) — Full contract audit + deployer + holders + sentiment
  • Wallet Intelligence Profile ($0.50) — PnL, style, associations, risk
  • Chain Health Report ($0.25) — Gas, congestion, MEV, TVL, governance
  • Cross-Chain Fund Trace ($1.50) — Follow money through bridges and mixers

Batch Processing (75-90% off)

  • Batch Token Scanner — 100 tokens, $0.05 per 10
  • Batch Wallet Analysis — 50 wallets, $0.03 per 10
  • Batch Pre-Buy Screen — 200 tokens, $0.02 per 50

AI Data Feeds

  • Market Context Feed ($9.99/mo) — LLM-optimized market summaries
  • Alpha Signal Feed ($19.99/mo) — Scored trading signals
  • Entity Relationship Graph ($14.99/mo) — Pre-computed wallet clusters

Agent Skills (18 Workflows)

Every agent gets 18 guided workflows teaching best practices:

Security & Vetting: Pre-Buy Token Vetting, Scam Investigation, Post-Rug Forensics, Compliance Screening

Trading & Execution: Launch Day Playbook, MEV/Sandwich Avoidance, Market Making Intelligence, Portfolio Defense

Alpha Discovery: Alpha Discovery Pipeline, Whale Movement Tracking, CEX Listing Prediction, Insider Trading Detection

DeFi & Yield: Yield Farming Optimizer, Cross-Chain Bridge Monitor, DAO Governance Intelligence

NFTs & Influencers: NFT Mint Sniper, KOL Performance Tracker, Airdrop Hunting

Access at GET /mcp/skills — includes anti-abuse rules and 4 ready-to-use agent prompts.

Technical Architecture

Caching Shield

Every data call passes through three layers:

  1. L1 Memory Cache — Sub-millisecond TTL lookup (8s-1hr depending on data type)
  2. Rate Limiter — Token bucket per provider (prevents burning free tier quotas)
  3. Provider Chain — Ordered fallback (3-4 providers per data type)

Provider Fallback Chains

Data Type Primary Fallback 1 Fallback 2 Fallback 3
Token Price Jupiter Solana Tracker DexScreener Binance
Token Metadata Helius DAS Solana Tracker Jupiter DexScreener
Wallet Balance Helius QuickNode Alchemy PublicNode
Risk Scan GoPlus RugCheck Honeypot Local Labels
EVM Funding Blockscout Etherscan Public RPC Boar MCP

Infrastructure

  • Server: Bare metal VPS, Docker Compose (30 containers)
  • Secrets: GPG-encrypted vault (76 secrets), age-encrypted runtime injection
  • CI/CD: GitHub Actions auto-deploy on push to main
  • Edge: Cloudflare Workers for x402 payment gateway
  • Observability: Langfuse cloud with smart sampling (20% normal, 100% errors)

Local MCP Servers

Two self-hosted MCP servers run on our infrastructure:

  • Solana SVM MCP (Rust, 32MB binary) — 60 RPC tools, WebSocket subscriptions, built-in x402
  • EVM MCP (TypeScript, bun runtime) — 25 tools across 86 networks, ENS, contracts, gas

API Reference

MCP Protocol (Streamable HTTP) 

POST /mcp                    JSON-RPC endpoint
GET  /mcp/tools              Tool catalog with input schemas
GET  /mcp/call/{tool_id}     Direct tool execution
GET  /.well-known/mcp        Server discovery
GET  /.well-known/x402       Payment protocol discovery

Platform Endpoints 

GET  /mcp/health             Uptime + response time
GET  /mcp/status             Cache stats, provider health
GET  /mcp/manifest           Auto-updating platform manifest
GET  /mcp/skills             18 agent workflow guides
GET  /mcp/membership         Plans, pricing, scan packs
GET  /mcp/sdk                Python/TS/curl quick-start
GET  /mcp/changelog          Version history
GET  /mcp/trials             Free trial status
GET  /mcp/earnings           Revenue dashboard

REST API 

POST /api/v1/investigate/trace    Wallet funding source tracing
POST /api/v1/investigate/scan     Full investigation
GET  /api/v1/investigate/chains   Supported chains
GET  /api/v1/cache/health         Caching shield status

Dashboard Pages 

/earnings          Revenue dashboard (auto-refreshing)
/investigate       Wallet investigation tool

SDKs & Integration

Python: pip install rmi-agent-sdk

from rmi_agent import RMIAgent
agent = RMIAgent()  # auto-discovers via /.well-known/mcp
result = agent.call("rug_pull_predictor", {"token": "So111..."})

TypeScript: npm install @rugmunch/agent-sdk

import { RMIAgent } from "@rugmunch/agent-sdk";
const agent = new RMIAgent();
const result = await agent.call("rug_pull_predictor", { token: "So111..." });

Directory Listings

  • Smithery: https://smithery.ai/server/@cryptorugmuncher/rug-munch-intelligence
  • Glama: https://glama.ai/mcp/servers/@cryptorugmuncher/rug-munch-intelligence
  • mcp.so: https://mcp.so/server/rug-munch-intelligence
  • GitHub: https://github.com/Rug-Munch-Media-LLC/rug-munch-intelligence-mcp
  • HuggingFace: https://huggingface.co/cryptorugmunch/rug-munch-intelligence

Version History

v3.4.0 (2026-06-21) — Crisis Ops Rebuild

  • Backend rewritten via strangler-fig: clean main.py (243 lines) replaces 8,475-line legacy
  • DataBus promoted to single source of truth (96 chains, 119 providers)
  • 14 frozen files — explicit un-freeze required before edit
  • AI-Forward Modules M1-M8 mandated across the system
  • Prometheus + AlertManager wired to @rmialerts Telegram channel
  • x402 MCP marketplace gateway live for tool-level micropayments
  • 5 new v1 routers: admin/alerts_webhook, databus, x402/payments, rag/search, scanner

v3.3.0 (2026-06-01)

  • 18 agent skills with workflow guides and anti-abuse rules
  • 4 membership tiers with daily call limits (60-90% discount)
  • 4 scan packs at 50-53% off individual tools
  • 4 real-time streaming feeds (WebSocket + webhook)
  • 4 deep research report products
  • 3 batch scanning products (75-90% off)
  • 3 AI-optimized data feeds for LLM consumption
  • 85 local MCP tools (Solana RPC + EVM 86 networks)
  • 50 free Boar blockchain tools (ETH, ENS, contracts)
  • Multi-provider caching shield on every data call
  • Platform manifest — single source of truth, auto-syncing
  • Earnings dashboard with wallet tracking
  • Quality endpoints: health, status, SDK, changelog, trials

v3.2.0 (2026-05-15)

  • POST /mcp JSON-RPC handler
  • inputSchema on every tool
  • Dynamic facilitator count
  • CORS headers for browser clients

v3.1.0 (2026-04-01)

  • /.well-known/mcp discovery
  • llms.txt for AI agent discovery
  • x402 payment protocol support
  • 8 payment facilitators across 13 chains

Contact: mcp@rugmunch.io | GitHub: github.com/Rug-Munch-Media-LLC Operations: @rmialerts (Telegram, Prometheus-wired)