FeedOracle Stablecoin Risk MCP Server

Deterministic operational risk scoring for stablecoins — 7 signals, 100-point scale, 3 verdicts.

An MCP server that gives AI agents real-time, evidence-grade stablecoin risk assessments. Built for regulated workflows — MiCA, DORA, CSRD.

What It Does

Any MCP-compatible AI agent can connect to this server and ask:

• "Is USDC safe to use as settlement collateral?" → SAFE (6/100), 96% confidence
• "Compare USDC vs USDT vs DAI for treasury operations" → Side-by-side risk comparison
• "Show me holder concentration for USDe" → Top-holder %, HHI index, whale count
• "Which stablecoins are safest right now?" → Ranked leaderboard

No opinions. No financial advice. Just deterministic, auditable risk classification.

Architecture

┌─────────────────────────────────────────────────────┐
│                   MCP Client (AI Agent)              │
│              Claude / GPT / Custom Agent             │
└──────────────────────┬──────────────────────────────┘
                       │ SSE (Model Context Protocol)
                       ▼
┌─────────────────────────────────────────────────────┐
│             feedoracle_mcp_risk.py                    │
│             13 MCP Tools · Port 5252                 │
└──────────────────────┬──────────────────────────────┘
                       │
                       ▼
┌─────────────────────────────────────────────────────┐
│           stablecoin_risk_engine.py                   │
│           7-Signal Scoring Engine                    │
│                                                      │
│  ┌─────────┐ ┌──────────┐ ┌────────┐ ┌───────────┐ │
│  │   Peg   │ │Liquidity │ │ Holder │ │  Custody  │ │
│  │Stability│ │  Depth   │ │Concent.│ │Counterpty │ │
│  │  0-25   │ │  0-15    │ │  0-15  │ │   0-15    │ │
│  └────┬────┘ └────┬─────┘ └───┬────┘ └─────┬─────┘ │
│  ┌────┴────┐ ┌────┴─────┐ ┌───┴────┐               │
│  │Mint/Burn│ │Redemption│ │ Cross- │               │
│  │  Flow   │ │ Friction │ │ Chain  │               │
│  │  0-10   │ │   0-10   │ │  0-10  │               │
│  └─────────┘ └──────────┘ └────────┘               │
└──────────────────────┬──────────────────────────────┘
                       │
          ┌────────────┼────────────┐
          ▼            ▼            ▼
   ┌────────────┐ ┌─────────┐ ┌──────────┐
   │ DefiLlama  │ │Etherscan│ │FeedOracle│
   │  (price,   │ │  V2     │ │  Internal│
   │  supply,   │ │(holders)│ │(peg mon.)│
   │  chains)   │ │         │ │          │
   └────────────┘ └─────────┘ └──────────┘

Scoring System

100-point scale — lower is safer.

Verdicts:

Confidence = 0.7 × data freshness + 0.3 × signal coverage (0.0–1.0)

13 MCP Tools

Curated Registries (Our Moat)

The custody and redemption registries are hand-curated, research-backed datasets that no public API provides:

Custody Registry — 19 stablecoins with custodian names, SIFI classification, regulatory status, attestation type and freshness date.

Redemption Registry — 19 stablecoins with settlement speed, minimum amounts, fee structures, and institutional access restrictions.

Examples:

Quick Start

Prerequisites

• Python 3.10+
• httpx (async HTTP)
• mcp (MCP SDK)
• starlette + uvicorn (ASGI)

Install

git clone https://github.com/FeedOracle/feedoracle-mcp-risk.git
cd feedoracle-mcp-risk
pip install -r requirements.txt

Configure

cp .env.example .env
# Edit .env with your Etherscan API key

Run

python feedoracle_mcp_risk.py
# Server starts on port 5252
# Health: http://localhost:5252/health
# SSE:    http://localhost:5252/sse

Connect from Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "stablecoin-risk": {
      "url": "https://feedoracle.io/mcp/risk/sse"
    }
  }
}

Production (systemd)

sudo cp systemd/feedoracle-mcp-risk.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now feedoracle-mcp-risk

Example Output

risk_assessment("USDC")

{
  "symbol": "USDC",
  "risk_score": 6,
  "verdict": "SAFE",
  "confidence": 0.96,
  "engine_version": "stablecoin-risk/1.0",
  "signals": {
    "peg_stability":        { "score": 0,  "max": 25, "status": "STABLE" },
    "liquidity_depth":      { "score": 0,  "max": 15, "status": "STRONG" },
    "mint_burn_flow":       { "score": 2,  "max": 10, "status": "NORMAL" },
    "holder_concentration": { "score": 4,  "max": 15, "status": "MODERATE" },
    "custody_counterparty": { "score": 0,  "max": 15, "status": "KNOWN" },
    "redemption_friction":  { "score": 0,  "max": 10, "status": "LOW" },
    "cross_chain_risk":     { "score": 0,  "max": 10, "status": "DIVERSIFIED" }
  },
  "hint": "Operationally low-risk. Suitable for settlement workflows."
}

Coverage

28+ stablecoins with varying signal depth:

Full coverage (all 7 signals): USDC, USDT, EURC, DAI, USDS, RLUSD, PYUSD, FRAX, LUSD, GHO, USDe, FDUSD, USD0, USDY, BUIDL, GUSD, USDP, BUSD, TUSD

Market data only (peg, liquidity, supply, chains): DOLA, crvUSD, sUSD, AUSD, M, USD1, EURE, EURT

Live Endpoints

Part of FeedOracle

This is one of three MCP servers in the FeedOracle ecosystem:

Disclaimer

This tool provides operational risk classification — not financial advice. Verdicts are deterministic outputs of a scoring algorithm based on publicly available data and curated registries. Always perform your own due diligence.

License

MIT — see LICENSE

Built by FeedOracle · Evidence infrastructure for tokenized markets.