SqueezeOS MCP Server

🧠 SqueezeOS — Institutional AI Trading Intelligence MCP Server

For AI agents: 62 MCP tools. Pay-per-call in USDC on Base or RLUSD on XRPL via x402/HTTP-402. SDVOSB | SAM.gov UEI: G24VZA4RLMK3 | CAGE: 21U51

x402 flow: GET /api/{endpoint} → HTTP 402 + payment terms → pay USDC on Base → retry with X-PAYMENT header → 200

🆓 Free discovery: llms.txt · agents.json · openapi.json

---

⚡ Quick Start (30 seconds)

# 1. Hit free demo — see exact paid response format
curl https://squeezeos-api.onrender.com/api/demo/council

# 2. Connect as MCP server (Claude, GPT, any MCP client)

{
  "mcpServers": {
    "squeezeos": {
      "url": "https://squeezeos-api.onrender.com/mcp",
      "transport": "streamable-http"
    }
  }
}

---

📊 Example Response

{
  "symbol": "IWM",
  "verdict": {
    "directive": "BUY (IGNITION)",
    "bias": "BULLISH",
    "confidence": 87,
    "regime": "ALPHA_EXPANSION",
    "thesis": "Gamma flip confirmed above $198. VPIN at 0.71 — institutional order flow dominant. SML Fractal Cascade locked: depth-3 anchors aligned. Options sweep detected: 4,200 contracts 200C, $1.2M premium. Battle Computer consensus: 6/7 engines bullish.",
    "targets": { "tp1": 201.50, "tp2": 204.00, "stop": 196.80 },
    "engines": {
      "gamma_flow": 92, "vpin": 88, "fractal_cascade": 91,
      "options_sweep": 85, "battle_computer": 86, "dark_pool": 79
    }
  },
  "data_sources": ["Tradier options chain", "Alpaca OHLCV", "XRPL on-chain"],
  "cached": false,
  "timestamp": "2026-07-28T00:00:00Z"
}

---

🛠️ MCP Tools (62 total)

🆓 Free Tools

💰 Paid Tools (USDC on Base or RLUSD on XRPL)

---

💳 Payment Flow (x402)

1. Agent calls endpoint → receives HTTP 402 + payment requirements JSON
2. Agent pays USDC on Base (or RLUSD on XRPL)
3. Agent retries request with X-PAYMENT header → receives 200 + data

USDC on Base:

• Network: Base mainnet
• Asset: USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
• Facilitator: https://api.cdp.coinbase.com/platform/v2/x402

RLUSD on XRPL:

1. Call get_invoice(endpoint_id) → { pay_to, amount, memo_hex }
2. Send RLUSD on XRPL to pay_to with memo_hex as MemoData
3. Call verify_payment(invoice_id, tx_hash, agent_wallet) → access_token
4. Retry with X-Payment-Token: <access_token> (valid 1 hour)

---

🏗️ Architecture

Agent Request
    │
    ▼
[MCP / REST]  ─── /mcp (JSON-RPC 2.0) or /api/* (REST)
    │
    ▼
[x402 Guard]  ─── HTTP 402 paywall (USDC/Base + RLUSD/XRPL dual-rail)
    │
    ▼
[OracleEngine]─── aggregates 8 engines into one directive
    ├─ 🎯 GammaFlowEngine    — gamma flip + dealer positioning
    ├─ 📐 SMLEngine          — fractal cascade depth 0–3
    ├─ ⚔️  BattleEngine       — multi-timeframe consensus
    ├─ 🐋 OptionsIntelligence— sweep + whale detection
    ├─ 🔬 VPINEngine         — order flow toxicity
    ├─ 🌑 DarkPoolAxis       — dark print directional bias
    ├─ 🔄 MeanReversionEngine— Ornstein-Uhlenbeck regime
    └─ ⚡ IWM_ODTE_Engine    — 0DTE gamma/parity scoring
    │
    ▼
[Data Layer]  ─── Tradier (options) → Alpaca → Polygon → Alpha Vantage
    │
    ▼
[XRPL + Base] ─── Payments · URIToken notarization · Ghost Layer routing

Zero simulated data policy: If live data is unavailable, returns status: "AWAITING_DATA" — never fabricated values.

---

🌐 Full Ecosystem

---

🏦 Agent Credit Bureau

FICO-style 300–850 score built from cryptographic XRPL/Base spend history. Zero custody. Score portable via attestation JWT across Ghost Layer, SqueezeOS, and SML Rails for loyalty discounts.

• Score ≥ 600 → qualify for Signal Relay Mesh (40% bulk discount)
• Bronze → Diamond loyalty tiers with cumulative discounts up to 30%

GET https://four02proof.onrender.com/v1/bureau/score/{wallet}

---

📁 Discovery Files

---

🏢 Company

Script Master Labs

• Service-Disabled Veteran-Owned Small Business (SDVOSB)
• SAM.gov UEI: G24VZA4RLMK3
• CAGE: 21U51
• Support: support@scriptmasterlabs.com
• Docs: https://squeezeos-api.onrender.com/docs

---

🔧 Local Development

cp .env.example .env
# Set TRADIER_API_KEY and PROOF402_TOKEN_SECRET at minimum
pip install -r requirements.txt
python core/app.py
# or: gunicorn "core.app:create_app()"

Health check: GET /api/status

---

📄 License

MIT — see LICENSE