# DPX MCP Server [![smithery badge](https://smithery.ai/badge/untitledfinancial/dpx-mcp)](https://smithery.ai/servers/untitledfinancial/dpx-mcp) [![npm version](https://badge.fury.io/js/%40untitledfinancial%2Fdpx-mcp.svg)](https://www.npmjs.com/package/@untitledfinancial/dpx-mcp) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) **AI-native infrastructure for institutional finance.** DPX exposes a 10+ layer intelligence oracle and a compliance-grade cross-border settlement rail as a single MCP server - any AI agent can read macro signals, score ESG counterparty risk, and execute settlements with no human in the loop. **13 tools** | **Base mainnet** | **GENIUS Act + MiCA + Basel III** | **x402 pay-per-call** --- ## What DPX is DPX is two things built as one system: **1. An AI intelligence layer** - a self-adjusting oracle that synthesizes 32+ real-time signals across climate, macroeconomics, FX, energy transition, supply chain, earth systems, and ESG. The oracle is not a static data feed: it recalibrates tier weights weekly against prediction outcomes (Platt scaling), stores scenario fingerprints in a Vectorize index, and runs a Claude AI synthesis layer on top of all nine data tiers. The intelligence endpoints are a standalone data product: pay-per-call in USDC via x402, no API key required. **2. A settlement rail** - cross-border USDC/EURC settlement on Base mainnet at 1.385% all-in, versus 2-5% for SWIFT or 5.4% for Stripe. Every settlement is ESG-scored, oracle-gated, and compliant with GENIUS Act (US), MiCA (EU), and Basel III by default. The same AI oracle that generates the intelligence briefings also gates whether a settlement executes. --- ## Intelligence endpoints (standalone data product) Deployed at `https://intelligence.untitledfinancial.com`. Pay per call in USDC on Base via [x402](https://x402.org) - no API key, no subscription. | Endpoint | Price | Cache | What it returns | |----------|-------|-------|-----------------| | `GET /intelligence` | $0.10 | live | AI narrative synthesis across all 32+ signals - score, tier, alerts, forward outlook | | `GET /intelligence/climate` | $0.25 | 24h | Precipitation anomalies across 10 agricultural zones vs 1972-74 baseline - commodity exposure, food inflation signals, basket currency implications | | `GET /intelligence/earth-systems` | $0.50 | 48h | Planetary health dashboard (Earth Health Index 0-100) - CO₂/CH₄/temp/sea ice vs pre-industrial, proximity to 9 climate tipping points | | `GET /intelligence/macro-stress` | $0.15 | 1h | Credit regime classification - IG/HY OAS spreads, TED, VIX, C&I lending tightening - 2-6 week lead signals for FX and commodity moves | | `GET /intelligence/supply-chain` | $0.25 | 6h | Lane bottleneck scoring - NY Fed GSCPI + live Rhine/Mississippi/Panama/Great Lakes water levels - goods inflation lead signal | | `GET /intelligence/energy-transition` | $0.25 | 24h | Renewable share, grid carbon intensity, fossil demand curve - structural energy price context | | `GET /intelligence/esg/:address` | $0.25 | 6h | Entity-level ESG score from GLEIF + SEC EDGAR + EPA ECHO + OSHA - counterparty due diligence | Data sources: Open-Meteo ERA5, NASA GISTEMP, NOAA GML, NSIDC, FRED (BAMLC0A0CM, BAMLH0A0HYM2, TEDRATE, VIXCLS, DRTSCILM), NY Fed GSCPI, WSV Pegelonline, USGS NWIS, EIA, GLEIF, SEC EDGAR, EPA ECHO, OSHA. **x402 example - no API key:** ```typescript import { withPaymentInterceptor } from 'x402-fetch'; const fetchWithPayment = withPaymentInterceptor(fetch, wallet); const data = await (await fetchWithPayment('https://intelligence.untitledfinancial.com/intelligence/macro-stress')).json(); // → { stressIndex: 42, regime: "LATE_CYCLE", leadSignals: { fxImplication: "USD_STRENGTH_RISK", ... } } ``` --- ## MCP tools (for AI agents) Install once, use from any MCP-compatible host (Claude Desktop, Cursor, n8n, custom agents). | Tool | Description | |------|-------------| | `get_manifest` | DPX protocol capabilities and contract addresses | | `get_quote` | Binding fee quote (300s TTL) - all-in rate with live ESG adjustment | | `get_esg_score` | Live ESG score for a wallet address - hourly from 6 institutional sources | | `get_reliability` | Oracle stability status - STABLE / CAUTION / UNSTABLE | | `get_oracle_status` | Full 10+ layer Stability Oracle v9.0 output - all tier scores, alerts, chaos regime flag, AI briefing | | `get_fee_schedule` | Complete fee table with volume tiers and competitive benchmarks | | `verify_fees` | Confirm off-chain quote matches on-chain DPXSettlementRouter | | `compare_to_competitors` | DPX vs Stripe, Wise, SWIFT, bank wire - dollar savings per transaction | | `get_rail_status` | Live health of local payment rails (PIX, SEPA, FedACH, CHAPS, UPI, PromptPay) | | `settle` | Execute a settlement - cross-border or domestic, sandbox or live | | `get_settlement_status` | Look up a settlement by ID - full audit record | | `get_investment_context` | Structured investment memo for AI due diligence agents | | `get_intelligence` | MPP-gated macro intelligence briefing from the Stability Oracle | --- ## Quick Start ### Claude Desktop Add to `~/Library/Application Support/Claude/claude_desktop_config.json`: ```json { "mcpServers": { "dpx": { "command": "npx", "args": ["-y", "@untitledfinancial/dpx-mcp"] } } } ``` Restart Claude Desktop. All 13 tools are immediately available. ### Remote HTTP (no install) ```json { "mcpServers": { "dpx": { "type": "http", "url": "https://mcp.untitledfinancial.com/mcp" } } } ``` ### Smithery ```bash npx @smithery/cli install @untitledfinancial/dpx-mcp --client claude ``` --- ## Example flows **AI agent settlement workflow:** ``` Agent: settle $2M USD → EUR for 0xRecipient... get_oracle_status → 10+ layer signal check - score 81, STABLE, no chaos regime get_esg_score → counterparty ESG tier confirmed (score 74 → 0.15% ESG fee) get_quote → $27,700 all-in at 1.385%, quoteId valid 300s verify_fees → on-chain fee matches off-chain quote ✓ settle → executed on Base mainnet, txHash + IPFS receipt returned ``` **Intelligence query (x402, no MCP):** ``` AI reads macro-stress → regime LATE_CYCLE, USD_STRENGTH_RISK flag → agent reduces FX exposure AI reads climate → wheat CRITICAL in South Asia → commodity desk alerted AI reads earth-systems → AMOC proximity HIGH → long-horizon risk model updated ``` --- ## Oracle architecture The 10+ layer Stability Oracle v9.0 underpins both the intelligence product and the settlement rail: | Layer | Signal | |-------|--------| | 0 - Climate & Environmental | 30-90 day lead indicators | | 1 - Commodities & Energy | Spot + structural signals | | 2 - Macroeconomic | 4 independent sources per indicator | | 3 - Currency & FX | 4 cross-validated APIs | | 4 - Basket Verification | On-chain Chainlink + 3 FX APIs | | 5 - Bond Yields | FRED yield curve | | 6 - Infrastructure + Conflict | Dual sub-modules | | 7 - Cross-Body Integration v8.0 | Geopolitical, capital flows, tech/AI supply chain | | 8 - USD Structural Health v9.0 | 25+ signals, 10% composite blend | | 9 - AI Synthesis | Claude reasoning layer - degrades gracefully | **Adaptive layer:** Tier weights recalibrate weekly against prediction outcomes via Platt scaling. Scenario fingerprints stored in Cloudflare Vectorize. Autonomous policy execution (basket rebalance, fee adjust) up to $10M notional with 23h cooling period and circuit breaker. --- ## Compliance GENIUS Act (US) | MiCA (EU) | EU SFDR/CSRD (transaction-level ESG) | Basel III | FCA/PSR (UK) | FATF Travel Rule --- ## Live contracts (Base mainnet) | Contract | Address | |----------|---------| | DPXSettlementRouter | `0x7d2b0Cea5A2d19369548F59C6B8EEe9Fe3495c97` | | DPXToken | `0x7A62dEcF6936675480F0991A2EF4a0d6f1023891` | | ESGCompliance | `0x7717e89bC45cBD5199b44595f6E874ac62d79786` | Verified on Sourcify. Full list: [get_manifest](#mcp-tools-for-ai-agents) --- ## Links - **Homepage**: [mcp.untitledfinancial.com](https://mcp.untitledfinancial.com) - **Intelligence API docs**: [INTELLIGENCE_API.md](https://github.com/untitledfinancial/dpx-mcp/blob/main/INTELLIGENCE_API.md) - **npm**: [@untitledfinancial/dpx-mcp](https://www.npmjs.com/package/@untitledfinancial/dpx-mcp) - **Smithery**: [smithery.ai/servers/untitledfinancial/dpx-mcp](https://smithery.ai/servers/untitledfinancial/dpx-mcp) - **Docs**: [docs.untitledfinancial.com](https://docs.untitledfinancial.com) --- ## License MIT © [Untitled Financial](https://untitledfinancial.com)