rmi-backend/docs/ARCHITECTURE.md

RMI Platform — System Architecture

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:

1. L1 Memory Cache — Sub-millisecond lookup. TTLs: 8s (price) to 1hr (contract ABI).
2. Rate Limiter — Token bucket per provider. Prevents burning free tier quotas.
3. 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 counts
• GET /mcp/membership — Membership tiers, scan packs, streams, research, batch
• GET /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