Netcup Server
ops: commit netcup-specific docs, config, and M3 Bayesian reputation on netcup mainline
846b6be RMI Platform — System Architecture
v3 (Jun 21 2026): This document now describes the rebuilt architecture. The legacy monolith has been replaced via strangler-fig. New v1 routes mount via
app/api/v1/__init__.pyaggregator. Seedocs/adr/0003-strangler-fig-not-rewrite.mdfor the migration pattern, anddocs/adr/0001-why-fastapi.mdfor framework choice.
v3 Architecture Diagram
┌─────────────────────┐
│ CONSUMERS │
│ Frontend | MCP │
│ Telegram | API │
└──────────┬──────────┘
│
┌────────────────────┼────────────────────┐
│ │ │
┌───────▼───────┐ ┌───────▼───────┐ ┌───────▼───────┐
│ MCP ENDPOINT │ │ REST v1 API │ │ X402 GATEWAY │
│ /mcp/* │ │ /api/v1/* │ │ CF Workers │
└───────┬───────┘ └───────┬───────┘ └───────┬───────┘
│ │ │
└────────────────────┼────────────────────┘
│
┌────────────▼────────────┐
│ app/api/v1/__init__.py │
│ AGGREGATOR (NEW) │
└────────────┬────────────┘
│
┌────────────────────────┼────────────────────────┐
│ │ │
┌─────────▼─────────┐ ┌──────────▼──────────┐ ┌─────────▼─────────┐
│ AUTH ROUTERS │ │ PUBLIC ROUTERS │ │ ADMIN ROUTERS │
│ alerts, wallet │ │ wallet, token, │ │ alerts_webhook │
│ │ │ scanner, databus │ │ (Prometheus) │
└───────────────────┘ └──────────┬──────────┘ └───────────────────┘
│
┌───────────▼───────────┐
│ DATABUS │
│ 96 chains, 119 prov. │
└───────────┬───────────┘
│
┌───────────────────────┼───────────────────────┐
│ │ │
┌─────────▼─────────┐ ┌──────────▼──────────┐ ┌────────▼────────┐
│ SERVICE LAYER │ │ PROVIDER CHAINS │ │ LOCAL MCP │
│ app/domain/* │ │ Jupiter → Helius → │ │ SVM + EVM │
│ (pure Python) │ │ Alchemy → … │ │ Self-hosted │
└───────────────────┘ └─────────────────────┘ └─────────────────┘
Overview
Rug Munch Intelligence is a unified crypto intelligence platform serving 234 tools across 9 provider categories. Every data call routes through a multi-layer caching shield with automatic provider fallback. The x402 micropayment layer handles paid tool access across 8 chains with instant settlement.
┌─────────────────────┐
│ FRONTEND / BOTS │
│ Web | Telegram | API│
└──────────┬──────────┘
│
┌────────────────────┼────────────────────┐
│ │ │
┌───────▼───────┐ ┌───────▼───────┐ ┌───────▼───────┐
│ MCP ENDPOINT │ │ REST API │ │ X402 GATEWAY │
│ /mcp/* │ │ /api/v1/* │ │ CF Workers │
└───────┬───────┘ └───────┬───────┘ └───────┬───────┘
│ │ │
└────────────────────┼────────────────────┘
│
┌────────────▼────────────┐
│ CACHING SHIELD │
│ L1 Memory → Rate Limit │
│ → Provider Chain │
└────────────┬────────────┘
│
┌────────────────────────┼────────────────────────┐
│ │ │
┌─────────▼─────────┐ ┌──────────▼──────────┐ ┌─────────▼─────────┐
│ DATA PROVIDERS │ │ LOCAL MCP SERVERS │ │ SERVICE MCP │
│ 20 sources │ │ SVM (60) + EVM (25)│ │ GMGN, Birdeye... │
└───────────────────┘ └─────────────────────┘ └───────────────────┘
Tool Categories
| Category | Count | Access | Description |
|---|---|---|---|
| Security Scanning | 45 | Free trial + paid | Rug pulls, honeypots, audits, clone detection |
| Wallet Intelligence | 38 | Free trial + paid | PnL, clustering, insider networks, whale tracking |
| Market Data | 32 | Free trial + paid | Prices, liquidity, volume, arbitrage, trends |
| Token Analytics | 28 | Free trial + paid | Holder distribution, sniper detection, deployer history |
| DeFi Analytics | 24 | Free trial + paid | TVL, yields, protocol risk, liquidity flow |
| Social Signals | 18 | Free trial + paid | Sentiment, KOL tracking, profile flips |
| Caching Shield | 13 | Free internal | Funding trace, risk scan, token price, wallet balance |
| Local MCP | 85 | Self-hosted | SVM Solana RPC, EVM blockchain queries |
| Free Public MCP | 50 | Free external | Boar blockchain (ETH, ENS, contracts) |
Caching Shield Architecture
Every data call goes through three layers before hitting any external API:
- L1 Memory Cache — Sub-millisecond lookup. TTLs: 8s (price) to 1hr (contract ABI).
- Rate Limiter — Token bucket per provider. Prevents burning free tier quotas.
- Provider Chain — Ordered fallback. If primary fails, next provider tried automatically.
Example: Token Price Request
Request → L1 cache (miss) → Rate check (allowed) → Jupiter (primary) →
if fail: Solana Tracker → if fail: DexScreener → if fail: Binance
Result cached for 8 seconds. Next request hits L1 cache instantly.
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 |
| Solana Funding | Helius | Solana Tracker | Public RPC | Local Labels |
Free Access Tiers
Free Trials (x402 Tools)
- Every paid tool includes 1-5 free trial calls
- No payment required for trial calls
- Fingerprint-gated anti-abuse protection
- Reset monthly or on tool updates
Always-Free Tools
- Funding Tracer — Trace wallet funding sources (Solana + 9 EVM chains)
- Token Price — Real-time price with multi-provider consensus
- Risk Scan — Quick security check with 4 fallback layers
- Wallet Balance — Balance lookup with provider redundancy
- GMGN Security — Token safety analysis
- Etherscan Gas — Current gas prices
- CoinGecko Price — Market data
- Langfuse Stats — Observability metrics
- All Local MCP Tools — 85 tools running on our infrastructure
Free Tier Limits (External APIs)
Solana Tracker: 5,000 requests/month across 2 accounts (6 RPS combined) Helius: 2 accounts, 25 RPS each (50 RPS total) Blockscout PRO: 100,000 credits/day, 5 RPS CoinMarketCap: 10,000 calls/month, 11 endpoints Boar MCP: Unlimited (keyless, read-only)
X402 Payment System
- Price range: $0.01 - $0.40 per tool call
- Payment chains: Base, Solana, Ethereum, BSC, TRON, Bitcoin, Polygon, Arbitrum
- 8 payment facilitators with automatic fallback
- Instant refund if tool returns no data
- Settlement: Instant on Base and Solana
Local MCP Servers
Two self-hosted MCP servers run on our bare metal, accessed via stdio transport:
Solana SVM MCP (60 tools, Rust)
- getBalance, getAccountInfo, getTokenSupply, getSignaturesForAddress
- getTransaction, getProgramAccounts, getBlock, getBlockHeight
- WebSocket subscriptions for real-time updates
- Built-in x402 payment protocol support
EVM MCP (25 tools, 86 networks)
- getBalance, getTokenBalance, getAllowance
- getTransaction, getTransactionReceipt, waitForTransaction
- getBlock, resolveENS, lookupENS
- getGasPrice, getContractABI, getChainInfo
Observability
Langfuse cloud with smart sampling:
- 20% of normal traces sent to cloud
- 100% of errors sent to cloud
- Full archive in local ClickHouse
- Target: 30,000 observations/month (free tier: 50,000)
Deployment
- Server: Bare metal VPS (193GB SSD, Ubuntu)
- Containers: Docker Compose (30 containers)
- CI/CD: GitHub Actions — auto-deploy on push to main
- Edge: Cloudflare Workers for x402 payment gateway
- Secrets: GPG-encrypted vault (52 secrets), age-encrypted Docker runtime
Auto-Updating Platform Manifest
All platform descriptions, tool counts, pricing, and agent skills are managed by a single source of truth at app/caching_shield/platform_manifest.py. Every external surface reads from here.
Live endpoints (always current):
GET /mcp/manifest— Full platform manifest with live tool countsGET /mcp/membership— Membership tiers, scan packs, streams, research, batchGET /mcp/skills— 18 agent skills with workflows and anti-abuse rules
Directory sync (run to update external listings):
python3 /root/backend/scripts/sync_platforms.py
Updates Smithery, Glama, mcp.so, and README from the manifest.
Tools by category (auto-counted):
| Category | Count | Access |
|---|---|---|
| Paid Tools (with free trials) | 200+ | 1-5 free calls, then pay-per-use |
| Local MCP Tools | 85 | Self-hosted, no rate limits |
| Free Public MCP | 50 | Keyless, read-only |
| Agent Skills | 18 | Free, included with any access |
| Scan Packs | 4 | 50-53% off individual tools |
| Membership Tiers | 4 | $4.99-$199.99/mo, daily call limits |
| Streaming Feeds | 4 | Real-time data via WebSocket |
| Research Reports | 4 | Deep dive investigations |
| Batch Products | 3 | 75-90% off bulk scanning |
| AI Data Feeds | 3 | Machine-ready market data |