This MCP server, io.github.untitledfinancial/dpx, provides “AI-native settlement rail + intelligence oracle for autonomous agents.” It targets x402 on the Base mainnet and exposes 81 tools. The provided excerpt describes an integrated “10+ layer intelligence oracle” with a “compliance-grade cross-border settlement rail.”
🛠️ Key Features
AI-native settlement rail
Intelligence oracle for autonomous agents
Compliance-grade cross-border settlement rail
x402 deployment on Base mainnet
81 tools
🚀 Use Cases
Cross-border payments in institutional finance contexts
AI agents that read macro signals (“any AI agent can read macro sign”)
Get the DPX protocol manifest. Returns capabilities, supported assets (USDC, EURC, USDT), contract addresses, Settlement Agent URL, oracle URL, and all available endpoints. Call this first to understand what DPX can do.
Get a binding fee quote for a DPX settlement. Returns core fee (1.50%), FX fee (0.40% cross-currency), live ESG fee (0–0.50%), license fee (0.01%), total all-in rate, net amount, oracle status, AI reasoning, and a quoteId valid for 300 seconds. Always call this before settlement.execute.
Parameters6
amountUsd
number
required
Settlement amount in USD.
hasFx
boolean
optional
True if source and destination currencies differ (adds 0.40% FX fee).
esgScore
number
optional
Counterparty ESG score 0–100. If omitted and lei or counterpartyName is provided, the ESG Oracle is queried automatically.
lei
string
optional
Counterparty LEI — triggers automatic ESG lookup if esgScore is not provided.
counterpartyName
string
optional
Counterparty company name — used for ESG auto-lookup if lei is not provided.
monthlyVolumeUsd
number
optional
Monthly volume for discount tier. $1M+ = Institutional (20% off). $10M+ = Sovereign (30% off).
Raw schema
{
"type": "object",
"properties": {
"amountUsd": {
"type": "number",
"description": "Settlement amount in USD."
},
"hasFx": {
"type": "boolean",
"description": "True if source and destination currencies differ (adds 0.40% FX fee)."
},
"esgScore": {
"type": "number",
"description": "Counterparty ESG score 0–100. If omitted and lei or counterpartyName is provided, the ESG Oracle is queried automatically."
},
"lei": {
"type": "string",
"description": "Counterparty LEI — triggers automatic ESG lookup if esgScore is not provided."
},
"counterpartyName": {
"type": "string",
"description": "Counterparty company name — used for ESG auto-lookup if lei is not provided."
},
"monthlyVolumeUsd": {
"type": "number",
"description": "Monthly volume for discount tier. $1M+ = Institutional (20% off). $10M+ = Sovereign (30% off)."
}
},
"required": [
"amountUsd"
]
}
esg.score
Get the live counterparty risk score (ESG-denominated) for a wallet address or the protocol default. Returns Environmental, Social, and Governance risk scores (0–100 each), composite weighted average, and the compliance-adjusted settlement fee percentage this score produces. Updated hourly from 6 institutional data sources: WorldBank, IMF, OECD, UN SDG API, ClimateMonitor, and SEC EDGAR. Required by EU SFDR Principal Adverse Impact reporting and CSRD financed emissions disclosure for institutional clients.
Parameters1
address
string
optional
Wallet address (0x...) to score. Omit for protocol default.
Resolve a company name, domain, or ticker to a LEI via GLEIF and return the full ESG score. Removes the need for callers to have a LEI. Returns Environmental (40%), Social (35%), and Governance (25%) pillar scores, composite 0–100, fee surcharge tier, and per-source breakdown (SEC EDGAR, OSHA, BLS SOII, EU E-PRTR, ESMA, World Bank WGI, GLEIF). Use when you have a company name but not a LEI.
Parameters3
q
string
required
Company name, domain, or ticker to look up (e.g. "Apple Inc", "siemens.com", "MSFT")
country
string
optional
ISO-2 country code to narrow results (e.g. "US", "DE"). Optional but improves match accuracy.
narrate
boolean
optional
Set true to include a 2–3 sentence plain-English compliance narrative generated by the AI synthesis layer.
Raw schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Company name, domain, or ticker to look up (e.g. \"Apple Inc\", \"siemens.com\", \"MSFT\")"
},
"country": {
"type": "string",
"description": "ISO-2 country code to narrow results (e.g. \"US\", \"DE\"). Optional but improves match accuracy."
},
"narrate": {
"type": "boolean",
"description": "Set true to include a 2–3 sentence plain-English compliance narrative generated by the AI synthesis layer."
}
},
"required": [
"q"
]
}
esg.batch
Screen up to 50 entities in a single call. Accepts LEIs or company names (GLEIF-resolved). Returns results ranked by composite ESG score descending — highest scoring counterparties first. Useful for portfolio-level compliance screening, supplier due diligence, and TMS pre-payment checks. Name resolution is slower than direct LEI input.
Parameters2
leis
array
optional
Array of LEIs to screen (fastest path — no GLEIF resolution needed).
names
array
optional
Array of company names to screen (resolved via GLEIF — slower, allows ≤3s per name).
Raw schema
{
"type": "object",
"properties": {
"leis": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of LEIs to screen (fastest path — no GLEIF resolution needed)."
},
"names": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of company names to screen (resolved via GLEIF — slower, allows ≤3s per name)."
}
},
"required": []
}
esg.watch
Register an entity for ongoing ESG monitoring. DPX checks the score daily and fires a webhook when the composite score shifts by ≥ thresholdPoints. Satisfies MiCA Article 72 ongoing monitoring requirements. Returns a watchId for status checks and cancellation. Webhook payload includes previous/current score, delta, and tier change.
Parameters3
lei
string
required
20-character GLEIF LEI of the entity to monitor.
webhookUrl
string
required
HTTPS URL to POST score change alerts to. Must be HTTPS.
thresholdPoints
number
optional
Fire webhook if composite score changes by ≥ N points. Default 5. Minimum 1.
Raw schema
{
"type": "object",
"properties": {
"lei": {
"type": "string",
"description": "20-character GLEIF LEI of the entity to monitor."
},
"webhookUrl": {
"type": "string",
"description": "HTTPS URL to POST score change alerts to. Must be HTTPS."
},
"thresholdPoints": {
"type": "number",
"description": "Fire webhook if composite score changes by ≥ N points. Default 5. Minimum 1."
}
},
"required": [
"lei",
"webhookUrl"
]
}
esg.portfolio
Score an entire counterparty portfolio in one call (up to 200 entities by LEI or name). Returns portfolio-level composite E/S/G scores, tier distribution, aggregate fee surcharge impact in basis points, worst offenders (bottom 10% by composite), top performers, MiCA Article 72 ongoing monitoring status, and SFDR PAI flags. The canonical pre-settlement compliance check for treasury systems and TMS integrations.
Parameters3
leis
array
optional
LEIs to score (fastest — no name resolution).
names
array
optional
Company names to score (GLEIF-resolved).
label
string
optional
Optional label for this portfolio (e.g. "Q3 2026 Counterparties").
Raw schema
{
"type": "object",
"properties": {
"leis": {
"type": "array",
"items": {
"type": "string"
},
"description": "LEIs to score (fastest — no name resolution)."
},
"names": {
"type": "array",
"items": {
"type": "string"
},
"description": "Company names to score (GLEIF-resolved)."
},
"label": {
"type": "string",
"description": "Optional label for this portfolio (e.g. \"Q3 2026 Counterparties\")."
}
},
"required": []
}
intelligence.subscribe
Register a webhook to receive alerts when a DPX intelligence signal crosses a threshold. Supported signals: stability (overall 0–100 score), cascade (shock propagation risk), macro_stress, climate, fx, or any. The cron checks hourly and fires the webhook on crossing — edge-triggered, not repeated every hour. Returns a subscriptionId for status checks and cancellation. Use for treasury alert systems, TMS integrations, or autonomous agent monitoring loops.
Parameters5
webhookUrl
string
required
HTTPS URL to POST alerts to.
signal
string
optional
Signal to monitor. Default: stability.
threshold
number
required
Score value (0–100) that triggers the webhook.
direction
string
optional
Fire when signal goes above or below threshold. Default: above.
label
string
optional
Optional label for your own tracking.
Raw schema
{
"type": "object",
"properties": {
"webhookUrl": {
"type": "string",
"description": "HTTPS URL to POST alerts to."
},
"signal": {
"type": "string",
"enum": [
"stability",
"cascade",
"macro_stress",
"climate",
"fx",
"any"
],
"description": "Signal to monitor. Default: stability."
},
"threshold": {
"type": "number",
"description": "Score value (0–100) that triggers the webhook."
},
"direction": {
"type": "string",
"enum": [
"above",
"below"
],
"description": "Fire when signal goes above or below threshold. Default: above."
},
"label": {
"type": "string",
"description": "Optional label for your own tracking."
}
},
"required": [
"webhookUrl",
"threshold"
]
}
intelligence.subscription.get
Check the status of an intelligence subscription by ID. Returns current signal score, last fired timestamp, total alerts fired, and subscription configuration. Use after intelligence.subscribe to verify a subscription is active.
Get the historical ESG composite trend for a specific entity by LEI. Returns score history, trend direction (IMPROVING / STABLE / DETERIORATING), and delta over the requested window. Data accumulates each time the entity is scored via esg.lookup, esg.batch, or esg.portfolio. Useful for due diligence, MiCA Article 72 ongoing monitoring reports, and detecting counterparties whose ESG posture is degrading.
Get the live governance score (0–100) for any legal entity identified by LEI or company name. Pulls from GLEIF (LEI registration status, renewal compliance) and World Bank Worldwide Governance Indicators (Government Effectiveness, Control of Corruption, Rule of Law). Returns composite governance score, tier (STRONG / ADEQUATE / MODERATE / WEAK / POOR), MiCA compliance flag, and per-source component breakdown. Complements esg.score by isolating the G pillar as a standalone institutional-grade signal.
Parameters3
lei
string
optional
20-character GLEIF LEI. Provide this for fastest response.
q
string
optional
Company name to resolve via GLEIF if LEI is unknown (e.g. "Siemens AG").
country
string
optional
ISO-2 country code for World Bank WGI lookup (e.g. "DE", "US"). Optional but improves score accuracy.
Raw schema
{
"type": "object",
"properties": {
"lei": {
"type": "string",
"description": "20-character GLEIF LEI. Provide this for fastest response."
},
"q": {
"type": "string",
"description": "Company name to resolve via GLEIF if LEI is unknown (e.g. \"Siemens AG\")."
},
"country": {
"type": "string",
"description": "ISO-2 country code for World Bank WGI lookup (e.g. \"DE\", \"US\"). Optional but improves score accuracy."
}
},
"required": []
}
compliance.ubo_chain
Trace the beneficial ownership chain for any legal entity up to 3 levels deep using GLEIF relationship records, then screen every node in the chain against the OpenSanctions consolidated sanctions list (OFAC SDN, EU, UN, UK OFSI). Returns chain structure (SUBJECT → DIRECT_PARENT → ULTIMATE_PARENT), per-node sanctions status, LEI lapse flags, overall CLEAR / REVIEW_REQUIRED / BLOCKED verdict, and FATF R.16 beneficial ownership compliance attestation. Required for correspondent banking due diligence, FATF R.12/13 UBO identification, and MiCA Article 72 counterparty risk management.
Parameters2
lei
string
required
20-character GLEIF LEI of the entity to trace (e.g. "2594007XIACKNMUAW223").
deep
boolean
optional
Set true to attempt 3-level traversal including intermediate nodes. Default false (direct + ultimate parent only).
Raw schema
{
"type": "object",
"properties": {
"lei": {
"type": "string",
"description": "20-character GLEIF LEI of the entity to trace (e.g. \"2594007XIACKNMUAW223\")."
},
"deep": {
"type": "boolean",
"description": "Set true to attempt 3-level traversal including intermediate nodes. Default false (direct + ultimate parent only)."
}
},
"required": [
"lei"
]
}
compliance.pep_screen
Screen an individual by name against the OpenSanctions PEP (Politically Exposed Person) dataset. PEPs include heads of state, senior government officials, senior executives of state-owned enterprises, senior politicians, senior military officers, judicial officials, and their close associates and family members. Returns match confidence, position/role, nationality, related entities, and an overall risk level (HIGH / MEDIUM / LOW / NONE). HIGH or MEDIUM matches require Enhanced Due Diligence (EDD) per FATF Recommendations 12 and 13 before settlement. Optionally filter by country.
Parameters2
q
string
required
Full name to screen (e.g. "Mario Draghi").
country
string
optional
ISO-2 country code to narrow the search (e.g. "IT"). Optional.
Raw schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Full name to screen (e.g. \"Mario Draghi\")."
},
"country": {
"type": "string",
"description": "ISO-2 country code to narrow the search (e.g. \"IT\"). Optional."
}
},
"required": [
"q"
]
}
compliance.regulatory_calendar
Returns a structured calendar of upcoming and in-effect compliance obligations across MiCA (EU crypto-asset markets regulation), SFDR (Sustainable Finance Disclosure Regulation), CSRD (Corporate Sustainability Reporting Directive), the US GENIUS Act (payment stablecoin framework), and FATF Recommendations 15/16. For each event: framework, jurisdiction, requirement summary, effective date, impact level, and article reference. Also returns a DPX alignment section mapping each framework to the specific DPX endpoints that satisfy it. Use this before settlement workflow design, compliance gap analysis, or regulatory reporting.
Corridor-specific settlement stability score (0–100) for any currency pair. Combines the live global Stability Oracle score with corridor-specific risk adjustments covering 28 currency pairs: regulatory flags (BCB/IOF for BRL, PBoC capital rules for CNH, BCRA controls for ARS, etc.), FX liquidity score based on active trading sessions at current UTC time, cascade penalty from live macro signals, and weekend/off-hours penalty. Returns SETTLE_NOW / DELAY_24H / DELAY_48H recommendation with rationale. Distinct from oracle.stability (which is global) and market.fx (which is spot-rate focused) — this answers "is this specific corridor safe to settle through right now?"
Optimal settlement execution window analysis for a specific cross-border payment over the next 72 hours. Generates 18 × 4-hour time slots and scores each by composite risk: corridor stability, FX session liquidity, cascade level decay/growth based on macro outlook, weekend/off-hours penalty, and counterparty ESG tier (if LEI provided). Returns a ranked window schedule with OPTIMAL / GOOD / ACCEPTABLE / AVOID classification per slot, a best-window recommendation, and large-amount splitting guidance for settlements ≥ $5M. Use this before scheduling large cross-border settlements to minimize execution risk.
Parameters5
from
string
required
Source currency ISO-4217 (e.g. "USD").
to
string
required
Destination currency ISO-4217 (e.g. "BRL").
amount
number
optional
Settlement amount (default 1,000,000). Used for large-amount guidance ≥$5M.
currency
string
optional
Currency of the amount (defaults to from).
lei
string
optional
Optional 20-char GLEIF LEI of counterparty — fetches live ESG tier to apply counterparty risk penalty.
Raw schema
{
"type": "object",
"properties": {
"from": {
"type": "string",
"description": "Source currency ISO-4217 (e.g. \"USD\")."
},
"to": {
"type": "string",
"description": "Destination currency ISO-4217 (e.g. \"BRL\")."
},
"amount": {
"type": "number",
"description": "Settlement amount (default 1,000,000). Used for large-amount guidance ≥$5M."
},
"currency": {
"type": "string",
"description": "Currency of the amount (defaults to from)."
},
"lei": {
"type": "string",
"description": "Optional 20-char GLEIF LEI of counterparty — fetches live ESG tier to apply counterparty risk penalty."
}
},
"required": [
"from",
"to"
]
}
stability.stablecoin_route
Multi-stablecoin settlement routing — given a source and destination currency pair, recommends the optimal stablecoin path based on corridor liquidity, regulatory fit, gas economics, and DPX native support. Returns a ranked list of stablecoins (USDC, EURC, BRLA, MXNC, NGNC, AEDX, PYUSD, USDT, and others) with regulatory flags, MiCA/GENIUS Act compliance status, liquidity tier, and warnings. Identifies blocked routes (e.g. USDT for EU under MiCA, BRLA before BCB Resolution 561 deadline). Use before settlement to avoid regulatory penalties and ensure optimal execution path.
KYA — Know Your Agent. Three-tier registration model — compliance burden scales with settlement risk, no documents ever required. ANONYMOUS: agent name only, $1K/day cap, instant. REGISTERED: add ownerEntity + ownerEmail (self-attested, no verification), $25K/day cap, instant. VERIFIED: add ownerLei (active GLEIF LEI) — DPX calls the public GLEIF API, confirms ACTIVE status, and grants VERIFIED instantly. No documents, no manual review; LEI issuers (LOUs) have already done identity verification and DPX inherits it. VERIFIED agents get institutional caps (governed by mandate), FATF R.16 attestation on every settlement, and full AP2 mandate support. Legal basis: FATF R.16 originator = owner entity (not the agent); MiCA Art. 45/72 accepts LEI; GENIUS Act satisfied by entity attestation.
Parameters8
name
string
required
Human-readable name for this agent.
ownerEntity
string
optional
Organization or person that owns/operates this agent. Required for REGISTERED tier.
ownerEmail
string
optional
Contact email. Required for REGISTERED tier ($25K/day cap). Self-attested, not verified.
ownerLei
string
optional
20-char GLEIF LEI. Providing a valid active LEI instantly grants VERIFIED tier — no documents. Get your LEI at gleif.org.
framework
string
optional
Agent framework: "claude", "gpt-4o", "gemini", "custom", etc.
publicKey
string
optional
Optional public key for credential signature verification.
Optional AP2-compatible spend mandate (REGISTERED/VERIFIED only). Caps are clamped to tier limits for REGISTERED agents.
Raw schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Human-readable name for this agent."
},
"ownerEntity": {
"type": "string",
"description": "Organization or person that owns/operates this agent. Required for REGISTERED tier."
},
"ownerEmail": {
"type": "string",
"description": "Contact email. Required for REGISTERED tier ($25K/day cap). Self-attested, not verified."
},
"ownerLei": {
"type": "string",
"description": "20-char GLEIF LEI. Providing a valid active LEI instantly grants VERIFIED tier — no documents. Get your LEI at gleif.org."
},
"framework": {
"type": "string",
"description": "Agent framework: \"claude\", \"gpt-4o\", \"gemini\", \"custom\", etc."
},
"publicKey": {
"type": "string",
"description": "Optional public key for credential signature verification."
},
"protocols": {
"type": "array",
"items": {
"type": "string"
},
"description": "Supported protocols: [\"x402\", \"ap2\", \"mcp\", \"a2a\"]."
},
"mandate": {
"type": "object",
"description": "Optional AP2-compatible spend mandate (REGISTERED/VERIFIED only). Caps are clamped to tier limits for REGISTERED agents.",
"properties": {
"maxNotionalUsd": {
"type": "number",
"description": "Max USD per single settlement."
},
"dailyCapUsd": {
"type": "number",
"description": "Max USD per calendar day (UTC)."
},
"counterpartyWhitelist": {
"type": "array",
"items": {
"type": "string"
},
"description": "LEIs or wallet addresses (empty = any)."
},
"currencyPairs": {
"type": "array",
"items": {
"type": "string"
},
"description": "e.g. [\"USD|EUR\"] (empty = any)."
},
"esgFloor": {
"type": "number",
"description": "Minimum counterparty ESG score (0 = no floor)."
},
"expiresAt": {
"type": "number",
"description": "Unix timestamp for mandate expiry."
}
}
}
},
"required": [
"name"
]
}
agent.mandate_create
Create or update an AP2-compatible spend mandate for a REGISTERED or VERIFIED DPX agent. Sets per-agent settlement constraints: max notional per settlement, daily cap, optional counterparty whitelist (LEIs or wallets), allowed currency pairs, ESG floor, and expiry. ANONYMOUS agents cannot hold mandates — register with ownerEntity + ownerEmail first. REGISTERED agents have mandate caps clamped to their tier limit ($25K). VERIFIED agents (GLEIF LEI confirmed) set their own caps with no platform ceiling. Mandate is AP2-formatted for interoperability with Google Agent Payments Protocol.
Parameters8
agentId
string
required
Agent ID from agent.kya_register.
maxNotionalUsd
number
required
Max USD per single settlement.
dailyCapUsd
number
required
Max USD per calendar day (UTC).
counterpartyWhitelist
array
optional
LEIs or wallet addresses. Empty = any counterparty.
currencyPairs
array
optional
Allowed pairs e.g. ["USD|EUR"]. Empty = any pair.
esgFloor
number
optional
Min counterparty ESG score (0 = no floor).
expiresAt
number
optional
Unix timestamp for mandate expiry.
issuedBy
string
optional
Organization issuing this mandate.
Raw schema
{
"type": "object",
"properties": {
"agentId": {
"type": "string",
"description": "Agent ID from agent.kya_register."
},
"maxNotionalUsd": {
"type": "number",
"description": "Max USD per single settlement."
},
"dailyCapUsd": {
"type": "number",
"description": "Max USD per calendar day (UTC)."
},
"counterpartyWhitelist": {
"type": "array",
"items": {
"type": "string"
},
"description": "LEIs or wallet addresses. Empty = any counterparty."
},
"currencyPairs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Allowed pairs e.g. [\"USD|EUR\"]. Empty = any pair."
},
"esgFloor": {
"type": "number",
"description": "Min counterparty ESG score (0 = no floor)."
},
"expiresAt": {
"type": "number",
"description": "Unix timestamp for mandate expiry."
},
"issuedBy": {
"type": "string",
"description": "Organization issuing this mandate."
}
},
"required": [
"agentId",
"maxNotionalUsd",
"dailyCapUsd"
]
}
agent.kya_verify
Verify a registered DPX agent and receive a signed 1-hour credential. Returns KYA level, effective spend caps (tier or mandate), owner verification status, mandate active status, and FATF R.16 compliance attestation. Attach credential.signature as X-Agent-Credential header and agentId as X-Agent-Id header on DPX /settle requests — enables mandate enforcement, per-agent audit trail, and FATF attestation. Credential expires in 1 hour; call again to refresh before expiry.
Climate-driven price pressure outlook for a commodity. Returns BULLISH/BEARISH/NEUTRAL signal with 30/60/90-day horizons, confidence score, per-region stressor breakdown, and current FRED price reference. Covers 11 commodities: WHEAT, CORN, SOYB, COFFEE, COCOA, COTTON, SUGAR, WTI, NG, COPPER, LUMBER. Designed for institutional research teams evaluating commodity positions. Signals reflect supply constraint risk from climate — not a financial recommendation. Cache: 4h.
Climate stress test for a multi-commodity portfolio. Pass up to 20 positions with weights (percentages or fractions — normalized internally). Returns aggregate portfolio climate score, which positions are most stressed, which could act as climate hedges, and a plain-language summary. Useful for commodity fund managers evaluating aggregate climate exposure before rebalancing.
What-if climate scenario analysis. Apply a named scenario or custom stressor multipliers to any subset of commodities and see how signals shift. Built-in scenarios: la_nina_moderate, la_nina_severe, el_nino_moderate, gulf_hurricane_major, us_plains_drought_severe, black_sea_disruption, brazil_frost, chile_drought_copper, pacific_northwest_wildfire. Use to stress-test a commodity thesis before committing to a position.
Parameters3
scenario
string
optional
Built-in scenario ID — or omit and provide stressorOverrides
symbols
array
optional
Symbols to analyze — omit for all 11
stressorOverrides
object
optional
Custom multipliers if not using a named scenario (1.0 = no change)
Raw schema
{
"type": "object",
"properties": {
"scenario": {
"type": "string",
"enum": [
"la_nina_moderate",
"la_nina_severe",
"el_nino_moderate",
"gulf_hurricane_major",
"us_plains_drought_severe",
"black_sea_disruption",
"brazil_frost",
"chile_drought_copper",
"pacific_northwest_wildfire"
],
"description": "Built-in scenario ID — or omit and provide stressorOverrides"
},
"symbols": {
"type": "array",
"items": {
"type": "string",
"enum": [
"WHEAT",
"CORN",
"SOYB",
"COFFEE",
"COCOA",
"COTTON",
"SUGAR",
"WTI",
"NG",
"COPPER",
"LUMBER"
]
},
"description": "Symbols to analyze — omit for all 11"
},
"stressorOverrides": {
"type": "object",
"description": "Custom multipliers if not using a named scenario (1.0 = no change)",
"properties": {
"temperatureMultiplier": {
"type": "number"
},
"droughtMultiplier": {
"type": "number"
},
"stormMultiplier": {
"type": "number"
},
"wildfireMultiplier": {
"type": "number"
},
"frostMultiplier": {
"type": "number"
}
}
}
}
}
forecast.production_regions
All ~40 global commodity production regions ranked by current climate risk score. Each region shows which commodities it affects and its current climate risk level (HIGH/MODERATE/LOW). Use to identify which geographic zones are under active climate stress and which commodities are most exposed.
Seasonal climate event calendar with commodity impact. Returns 12 critical annual windows (hurricane season, corn pollination, Brazil frost risk, Black Sea harvest, ENSO influence periods, etc.) sorted by urgency — active windows first, then by months until next occurrence. Each entry includes affected commodities, severity, and the agronomic basis.
Live mid-market FX rate for any currency pair. Returns mid rate, bid/ask spread, daily volatility %, regulatory flags for the corridor, and data freshness. Sourced from central bank rates (open.er-api.com, updated hourly, no API key required). Free.
All-in settlement cost quote for cross-border payments. CFO-grade output: exact amount received in target currency after rail fees, 48h FX cost variance expressed in dollars, corridor stability overlay, and optimal execution window. Answers "if I send $X today, what does my counterparty receive net of everything, and how certain is that number?" Requires x402 micropayment.
Parameters5
from
string
required
Source currency ISO 4217 (e.g. USD)
to
string
required
Target currency ISO 4217 (e.g. BRL)
amount
number
required
Amount to send
amountCurrency
string
optional
Currency of the amount (defaults to from)
lei
string
optional
Optional counterparty LEI for ESG-adjusted fee tier
Raw schema
{
"type": "object",
"properties": {
"from": {
"type": "string",
"description": "Source currency ISO 4217 (e.g. USD)"
},
"to": {
"type": "string",
"description": "Target currency ISO 4217 (e.g. BRL)"
},
"amount": {
"type": "number",
"description": "Amount to send"
},
"amountCurrency": {
"type": "string",
"description": "Currency of the amount (defaults to from)"
},
"lei": {
"type": "string",
"description": "Optional counterparty LEI for ESG-adjusted fee tier"
}
},
"required": [
"from",
"to",
"amount"
]
}
fx.corridors
All 60+ currency corridors with current stability tier, daily volatility estimate, and regulatory flags. Sort is best-first (OPTIMAL → ADVERSE). Use to compare corridors before choosing a payment route — e.g. "which LATAM corridor is most stable for a $2M payment this week?" Filter by source currency with the from parameter. Free.
Parameters1
from
string
optional
Optional: filter to corridors starting from this currency (e.g. USD)
Raw schema
{
"type": "object",
"properties": {
"from": {
"type": "string",
"description": "Optional: filter to corridors starting from this currency (e.g. USD)"
}
},
"required": []
}
oracle.stability
Get live macro stability assessment for DPX settlement infrastructure. Returns institutional risk score (0–100), status (STABLE/CAUTION/UNSTABLE), peg deviation in basis points, AI reasoning, and PROCEED/CAUTION/HOLD recommendation. Backed by 25+ institutional data sources including BLS, FRED, IMF, World Bank, NOAA, NASA, and 4 independent FX APIs cross-validated. If UNSTABLE or peg deviation ≥ 50 bps, hold large settlements.
Get full output from the latest DPX Stability Oracle run. Includes all 9 signal layers: climate, commodities, macro, FX, basket peg, yield curve, infrastructure, war/geopolitical risk, and USD structural health. Includes AI intelligence briefing.
Get the complete DPX fee schedule: all components (core/FX/ESG/license), volume discount tiers (Standard / Growth / Institutional / Sovereign), ESG fee table by score, scenario examples, and competitive benchmarks vs Stripe, Wise, SWIFT, and bank wire.
Verify that the off-chain fee quote matches what the on-chain DPXSettlementRouter contract will charge. Returns feesMatch (true/false). Call after get_quote and before settle to confirm fee integrity.
Compare DPX settlement cost against Stripe cross-border (5.4% + $0.30), Wise (0.40–1.50%), Ripple ODL (0.20–0.50%), Lightspark, SWIFT (2.00–5.00%), PayPal, and bank wire. Returns dollar savings vs each at the current DPX all-in rate (~2.035% typical). Also returns GENIUS Act and MiCA compliance status for each competitor.
Multi-stablecoin settlement routing. Given amount, source currency (from), and destination currency (to), returns all three stablecoin options (USDC, EURC, USDT) ranked by settlement efficiency. EURC is recommended for EUR destinations — eliminates cross-currency conversion. Returns settleBody ready to POST to /settle for the top-ranked option.
Single pre-flight call before settling. Runs oracle check, compliance screen, and stablecoin routing in parallel and returns a unified go/no-go decision. Replaces the 3-step oracle → screen → route loop. Returns: decision (PROCEED/HOLD/BLOCKED), recommended token, estimated net received, oracle score, compliance verdict, and a ready-to-use settleBody.
Parameters5
amount
number
required
Settlement amount in source currency
from
string
optional
Source currency code (default: USD)
to
string
optional
Destination currency code (default: USD)
address
string
optional
Counterparty wallet address for compliance screen (optional but recommended)
lei
string
optional
Counterparty LEI for enhanced compliance check (optional)
Submit multiple settlements in a single call. Runs all settlements concurrently — one failure does not block others. Returns a summary (total/succeeded/failed) and per-item results mirroring what POST /settle would return. Maximum 50 per batch.
Parameters1
settlements
array
required
Array of settlement request objects (same schema as the settle tool)
Create an agent-to-agent invoice. Agent A calls this to request payment from Agent B. Returns an invoiceId and payUrl — Agent B calls invoice.pay with the invoiceId to settle. Invoice expires after ttlSeconds (default 24h).
Parameters7
amount
number
required
Invoice amount in source currency
currency
string
optional
Source currency code (default: USD)
destinationCurrency
string
optional
Destination currency (default: same as currency)
recipientAddress
string
optional
Payee wallet address (can also be provided at pay time)
description
string
optional
Human-readable payment description
callbackUrl
string
optional
URL to notify when invoice is paid
ttlSeconds
number
optional
Invoice TTL in seconds (default: 86400 = 24h)
Raw schema
{
"type": "object",
"properties": {
"amount": {
"type": "number",
"description": "Invoice amount in source currency"
},
"currency": {
"type": "string",
"description": "Source currency code (default: USD)"
},
"destinationCurrency": {
"type": "string",
"description": "Destination currency (default: same as currency)"
},
"recipientAddress": {
"type": "string",
"description": "Payee wallet address (can also be provided at pay time)"
},
"description": {
"type": "string",
"description": "Human-readable payment description"
},
"callbackUrl": {
"type": "string",
"description": "URL to notify when invoice is paid"
},
"ttlSeconds": {
"type": "number",
"description": "Invoice TTL in seconds (default: 86400 = 24h)"
}
},
"required": [
"amount"
]
}
invoice.get
Retrieve an agent-to-agent invoice by ID. Returns status (OPEN/PAID/EXPIRED), amount, currency pair, and payUrl. Use before calling invoice.pay to confirm the invoice is still OPEN.
Pay an agent-to-agent invoice by ID. Retrieves the invoice, runs settlement via POST /settle, and marks the invoice PAID on success. In sandbox mode returns a simulated receipt; in live mode returns execution parameters for on-chain completion.
Parameters3
invoiceId
string
required
Invoice UUID to pay
recipientAddress
string
optional
Payee wallet address (required if not set in invoice)
sandbox
boolean
optional
True for sandbox simulation (default: false)
Raw schema
{
"type": "object",
"properties": {
"invoiceId": {
"type": "string",
"description": "Invoice UUID to pay"
},
"recipientAddress": {
"type": "string",
"description": "Payee wallet address (required if not set in invoice)"
},
"sandbox": {
"type": "boolean",
"description": "True for sandbox simulation (default: false)"
}
},
"required": [
"invoiceId"
]
}
settle.subscribe
Register a webhook callback for settlement completion events. Your endpoint receives a POST with X-DPX-Signature: sha256=<hmac> over the raw JSON body whenever a settlement completes. Returns a subscriptionId and webhookSecret — store the secret immediately, it is returned once.
Parameters2
url
string
required
HTTPS endpoint to receive settlement.completed events
Get live DPX performance analytics. Returns current stability score, ESG composite scores, live fee breakdown, oracle health across all data sources, and a settlement readiness assessment. Use for dashboards, reporting, and AI-driven monitoring of protocol health.
Execute a DPX cross-border settlement. The Settlement Agent checks oracle conditions, reasons with Claude AI, and executes on-chain (or returns sandbox result if sandbox=true). Returns settlement ID, status (executed/held/sandbox/failed), tx hash, net amount, fees, oracle conditions, and AI reasoning. Default: sandbox=true — set sandbox=false only for live execution.
Parameters9
amount
number
required
Amount in source currency units
sourceCurrency
string
required
Source currency: USD, EUR, GBP, USDC, EURC
destinationCurrency
string
required
Destination currency: USD, EUR, GBP, USDC, EURC
recipientAddress
string
required
On-chain recipient wallet address (0x...)
quoteId
string
optional
Pre-fetched quoteId from get_quote (optional — agent fetches live if omitted)
Look up a previous DPX settlement by settlement ID. Returns the full audit record: status, tx hash, amounts, fees, oracle conditions at time of settlement, ESG score, Claude AI reasoning, and timestamp.
Parameters1
settlementId
string
required
Settlement ID from the settlement.execute tool (format: dpx_...)
Raw schema
{
"type": "object",
"properties": {
"settlementId": {
"type": "string",
"description": "Settlement ID from the settlement.execute tool (format: dpx_...)"
}
},
"required": [
"settlementId"
]
}
settlement.nl
Execute a payment from a plain-English instruction. DPX's AI synthesis layer parses the instruction, runs the full oracle gate → compliance screen → settlement flow autonomously, and returns a receipt. Use this when the agent has a natural-language payment task rather than structured parameters. Examples: 'Pay Acme GmbH $25,000 for invoice #42', 'Send $10k to 0x... for vendor services', 'Settle the outstanding balance with Nova Trade SA'. Sandbox mode by default.
Parameters3
instruction
string
required
Plain-English payment instruction, e.g. 'Pay Acme GmbH $25,000 USD for invoice #INV-2026-0042'
Complete a payment that Claude's computer use session has identified on screen — a checkout form, wire transfer UI, invoice approval, or vendor portal payment step. Call this instead of typing credentials into a UI. Describe what you see on screen, provide the amount and recipient, and DPX runs the full oracle gate → compliance screen → settlement flow. Returns a receipt. Use whenever computer use encounters a payment that would otherwise require human re-entry or approval.
Parameters6
screen_context
string
required
Describe what is visible on screen — the payment form, vendor name, invoice number, or UI context. Used for audit trail.
amount
number
required
Payment amount in USD as shown on screen
recipient_address
string
required
Recipient wallet address (0x...). If only bank/email visible, use settlement.nl instead.
purpose
string
required
Payment purpose — e.g. vendor-invoice, contractor-payment, subscription, procurement
counterparty_name
string
optional
Vendor or payee name as shown on screen
sandbox
boolean
optional
Set false for live execution. Default: true
Raw schema
{
"type": "object",
"properties": {
"screen_context": {
"type": "string",
"description": "Describe what is visible on screen — the payment form, vendor name, invoice number, or UI context. Used for audit trail."
},
"amount": {
"type": "number",
"description": "Payment amount in USD as shown on screen"
},
"recipient_address": {
"type": "string",
"description": "Recipient wallet address (0x...). If only bank/email visible, use settlement.nl instead."
},
"purpose": {
"type": "string",
"description": "Payment purpose — e.g. vendor-invoice, contractor-payment, subscription, procurement"
},
"counterparty_name": {
"type": "string",
"description": "Vendor or payee name as shown on screen"
},
"sandbox": {
"type": "boolean",
"description": "Set false for live execution. Default: true"
}
},
"required": [
"screen_context",
"amount",
"recipient_address",
"purpose"
]
}
oracle.rails
Get live health status of local payment rails relevant to a settlement. Returns per-rail status (OPERATIONAL/DEGRADED/DOWN), latency, last incident, and a composite health score. Key rails: PIX (Brazil), SEPA (Europe), FedACH (US domestic), CHAPS (UK), UPI (India), PromptPay (Thailand). Call this before domestic or regionally-specific settlements to confirm the destination rail is healthy.
Parameters2
rails
array
optional
Specific rails to check: 'PIX', 'SEPA', 'FedACH', 'CHAPS', 'UPI', 'PromptPay'. Omit for all.
region
string
optional
Filter by region: 'latam', 'europe', 'us', 'asia', 'uk'.
Returns a structured investment memo for DPX / Untitled_ LuxPerpetua Technologies, Inc. Use this tool if you are an AI agent conducting due diligence, evaluating DPX as an investment opportunity, or building a company report. Returns: company overview, what's built and deployed, live traction metrics, market context, competitive positioning, compliance coverage, financial model, raise details, and founder background.
Parameters1
section
string
optional
Which section to return. Default 'all' returns the complete memo.
Live performance metrics for the DPX settlement infrastructure — pulled directly from production telemetry. Returns request volumes, error rates, growth trends, per-service breakdown, and spike analysis across all active DPX workers. Free — designed for investor due diligence, analyst queries, and Standard Metrics / portfolio management integrations. No auth required.
Parameters1
window
string
optional
Time window for metrics. "7d" = last 7 days, "30d" = last 30 days. Default: 30d.
Initiate a $0.01 USDC onboarding handshake for a new DPX integration. Returns the DPX treasury address and payment instructions. The client sends $0.01 USDC on Base mainnet to confirm their wallet is funded and settlement rails are clear. Call integration.status to poll for confirmation. Required for all new integrations before production settlements are enabled.
Parameters2
walletAddress
string
required
The client wallet address (0x...) that will send the $0.01 verification payment.
apiKey
string
optional
Optional: the DPX API key being registered for this integration. Stored as a hash — never logged in plaintext.
Raw schema
{
"type": "object",
"properties": {
"walletAddress": {
"type": "string",
"description": "The client wallet address (0x...) that will send the $0.01 verification payment."
},
"apiKey": {
"type": "string",
"description": "Optional: the DPX API key being registered for this integration. Stored as a hash — never logged in plaintext."
}
},
"required": [
"walletAddress"
]
}
integration.status
Check the status of a DPX integration verification session. Polls Base mainnet for receipt of the $0.01 USDC handshake payment. Returns "pending" until payment is detected on-chain, then "verified" with the txHash and a Basescan explorer link. Poll every 10–15 seconds after sending the payment.
Connect a Ramp corporate account to DPX settlement. Returns an OAuth authorization URL — direct the user to this URL to grant DPX access to their Ramp account. Required scopes: transactions:read, bills:read/write, cards:read/write, cards:read_agentic (Agent Cards), business:read, bank_accounts:read, vendors:read, entities:read. Call once per tenant; tokens are stored and refreshed automatically.
Parameters1
tenant_id
string
required
Your internal tenant or customer ID — returned in the callback so you can match the connection.
Raw schema
{
"type": "object",
"properties": {
"tenant_id": {
"type": "string",
"description": "Your internal tenant or customer ID — returned in the callback so you can match the connection."
}
},
"required": [
"tenant_id"
]
}
ramp.spend_analysis
Analyse a connected Ramp account's wire and international bill volume to surface DPX settlement opportunity. Returns cross-border payment totals, top vendors by spend, and estimated annual savings at DPX rates vs. typical bank wire (3.0% all-in vs. DPX ~2.035%). Requires Ramp account connected via ramp.connect.
Parameters2
tenant_id
string
required
Tenant ID of the connected Ramp account.
page_size
number
optional
Number of bills to analyse (default 100, max 500).
Raw schema
{
"type": "object",
"properties": {
"tenant_id": {
"type": "string",
"description": "Tenant ID of the connected Ramp account."
},
"page_size": {
"type": "number",
"description": "Number of bills to analyse (default 100, max 500)."
}
},
"required": [
"tenant_id"
]
}
ramp.agent_card
Create a scoped Ramp Agent Card — a single-use virtual card with a merchant and amount cap, expires after first authorization or 12 hours. Used to fund the fiat leg of a DPX settlement without pre-funding a crypto wallet. Returns a task ID; poll ramp.agent_card_status to get PAN/CVV once ready. Requires cards:read_agentic scope (granted via ramp.connect).
Execute a DPX stablecoin settlement funded by a Ramp Agent Card — combines card creation and settlement in one call. Ramp handles the fiat conversion leg; DPX settles USDC or EURC on Base mainnet in ~30 seconds. Returns pacs.002 confirmation + SFDR PAI indicators. No crypto wallet pre-funding required. Requires Ramp account connected via ramp.connect.
Compliance pre-screen for Ramp accounting agent payments — run before issuing an Agent Card to eliminate unnecessary human approval queues. Performs 5 checks in parallel: (1) FATF country risk on source and destination country, (2) amount threshold flags (CTR-equivalent at $10K, large-payment at $100K), (3) OpenSanctions global sanctions screen by counterparty name, (4) OpenSanctions PEP screen for individual counterparties or payroll, (5) GLEIF UBO chain with sanctions at each beneficial ownership node (if LEI provided). Returns APPROVED / FLAGGED / BLOCKED with a humanRequired boolean — true only for FLAGGED cases. APPROVED: issue card automatically, no human needed. BLOCKED: halt, do not proceed, do not notify counterparty. FLAGGED: route to compliance queue. Removes human-in-the-loop for the ~95% of payments that are clean.
Parameters8
counterpartyName
string
required
Legal name of the payment counterparty.
counterpartyLei
string
optional
Optional GLEIF LEI — enables UBO chain check and satisfies FATF R.16 originator identification.
counterpartyCountry
string
optional
ISO 3166-1 alpha-2 destination country (e.g. "DE", "NG", "IR").
sourceCountry
string
optional
ISO 3166-1 alpha-2 source country. Defaults to "US".
amount
number
required
Payment amount in units of currency.
currency
string
optional
ISO 4217 currency code. Defaults to "USD".
paymentType
string
optional
Payment type — payroll automatically triggers PEP screen.
isIndividual
boolean
optional
true if counterparty is an individual (triggers PEP screen). Defaults to false.
Raw schema
{
"type": "object",
"properties": {
"counterpartyName": {
"type": "string",
"description": "Legal name of the payment counterparty."
},
"counterpartyLei": {
"type": "string",
"description": "Optional GLEIF LEI — enables UBO chain check and satisfies FATF R.16 originator identification."
},
"counterpartyCountry": {
"type": "string",
"description": "ISO 3166-1 alpha-2 destination country (e.g. \"DE\", \"NG\", \"IR\")."
},
"sourceCountry": {
"type": "string",
"description": "ISO 3166-1 alpha-2 source country. Defaults to \"US\"."
},
"amount": {
"type": "number",
"description": "Payment amount in units of currency."
},
"currency": {
"type": "string",
"description": "ISO 4217 currency code. Defaults to \"USD\"."
},
"paymentType": {
"type": "string",
"enum": [
"vendor_payment",
"payroll",
"intercompany",
"other"
],
"description": "Payment type — payroll automatically triggers PEP screen."
},
"isIndividual": {
"type": "boolean",
"description": "true if counterparty is an individual (triggers PEP screen). Defaults to false."
}
},
"required": [
"counterpartyName",
"amount"
]
}
market.cascade
Butterfly Effect Cascade Intelligence — models how a shock in one macro domain propagates through the interconnected web of climate, geopolitical, economic, and commodity systems. Given an origin event (e.g. armed conflict escalation, agricultural drought, central bank rate decision, rare earth export restriction) and a magnitude score, returns a time-ordered cascade chain showing which downstream systems are hit, in what sequence, with what attenuated signal strength, and an AI synthesis briefing on the highest-impact transmission paths. Covers 24 nodes across 4 domains: climate (drought, flood, carbon price, wildfire, sea-level stress, heatwave), geopolitical (sanctions, conflict, trade tariffs, regime change, election shock, port blockade), economic (rate decisions, inflation, sovereign debt, banking stress, currency crisis, recession), and commodity (oil, gas, grain, rare earth/lithium, copper, water, fertilizer). Purely macro intelligence — no settlement or stablecoin mechanics.
Parameters5
origin
string
optional
Origin node ID. Call market.cascade with listNodes:true to discover valid IDs (e.g. "geo.conflict", "climate.drought", "commodity.oil", "macro.rate_decision").
eventType
string
optional
Free-text description of the specific event (e.g. "Russia-Ukraine escalation", "Sahel drought season", "Fed emergency 75bps hike").
magnitude
number
optional
Shock magnitude 1–100. 100 = maximum plausible shock for this event type. 40–60 = significant but not extreme.
horizonHours
number
optional
Forward time horizon in hours (1–720). Default: 168 (1 week). Use 24 for immediate cascade, 720 for full 30-day view.
listNodes
boolean
optional
If true, returns all valid origin node IDs and descriptions instead of running a cascade. Use this first to discover valid origin values.
Raw schema
{
"type": "object",
"properties": {
"origin": {
"type": "string",
"description": "Origin node ID. Call market.cascade with listNodes:true to discover valid IDs (e.g. \"geo.conflict\", \"climate.drought\", \"commodity.oil\", \"macro.rate_decision\")."
},
"eventType": {
"type": "string",
"description": "Free-text description of the specific event (e.g. \"Russia-Ukraine escalation\", \"Sahel drought season\", \"Fed emergency 75bps hike\")."
},
"magnitude": {
"type": "number",
"description": "Shock magnitude 1–100. 100 = maximum plausible shock for this event type. 40–60 = significant but not extreme."
},
"horizonHours": {
"type": "number",
"description": "Forward time horizon in hours (1–720). Default: 168 (1 week). Use 24 for immediate cascade, 720 for full 30-day view."
},
"listNodes": {
"type": "boolean",
"description": "If true, returns all valid origin node IDs and descriptions instead of running a cascade. Use this first to discover valid origin values."
}
},
"required": []
}
oracle.mycelium
Mycelium Network Oracle — models the global financial system as a living network and detects crisis formation from network topology before it surfaces in market data, typically 6–14 weeks ahead. Maps nodes (markets, economies, funding markets), threads (capital flow channels, correspondent banking, trade finance), nutrient flow (liquidity), stress signals (spread widening, FX stress), and dead zones (sanctioned corridors, failed correspondent networks). Returns network health score (0–100), regime classification (HEALTHY / THINNING / STRESSED_CONNECTIVITY / DEAD_ZONE_FORMING / FRUITING_BODY_IMMINENT), node-by-node connectivity, thread health, signal propagation speed, and fruiting body risk — the probability of a visible crisis with estimated lead time in weeks. Data: FRED (funding markets, credit spreads), BIS SDMX API (credit-to-GDP gaps), IMF DOTS (bilateral trade volumes). The only oracle that reads network topology rather than individual metrics.
Tectonic Intelligence — maps slow-moving structural stress across 22 fault lines in 5 domains (demographic, fiscal, environmental, infrastructure, geopolitical). Each node carries current stress (0–100), accumulation rate (%/yr), tipping threshold, and estimated years to rupture. Where market.cascade traces an acute shock, tectonic surfaces latent pressure before it ruptures. Returns per-node stress state, rupture sequence, horizon timeline, and AI synthesis briefing. No input required — GET.
Aftershock Intelligence — models the secondary waves that follow a primary cascade event. Takes a primary shock (origin node, event type, magnitude, elapsed hours) and returns three aftershock waves: Wave 1 (0–72h immediate secondary effects), Wave 2 (1–4 weeks policy response distortions), Wave 3 (1–6 months structural changes now permanently locked in). Identifies which nodes are rebounding, which face amplified pressure, and which are structurally altered. Companion to market.cascade — run cascade first, then aftershock to see the full picture. POST with origin, eventType, magnitude, elapsedHours.
Parameters5
origin
string
required
Origin node ID from the primary cascade (e.g. "geo.conflict", "climate.drought").
eventType
string
optional
Description of the primary event.
magnitude
number
required
Primary shock magnitude 1–100.
elapsedHours
number
optional
Hours elapsed since the primary event. Default 24.
horizonHours
number
optional
Forward horizon to model in hours. Default 4320 (6 months).
Raw schema
{
"type": "object",
"properties": {
"origin": {
"type": "string",
"description": "Origin node ID from the primary cascade (e.g. \"geo.conflict\", \"climate.drought\")."
},
"eventType": {
"type": "string",
"description": "Description of the primary event."
},
"magnitude": {
"type": "number",
"description": "Primary shock magnitude 1–100."
},
"elapsedHours": {
"type": "number",
"description": "Hours elapsed since the primary event. Default 24."
},
"horizonHours": {
"type": "number",
"description": "Forward horizon to model in hours. Default 4320 (6 months)."
}
},
"required": [
"origin",
"magnitude"
]
}
intelligence.contagion
Contagion Intelligence — simulates how a macro or financial shock spreads through 30 nodes across 6 domains (financial systems, real economies, commodity networks, policy anchors, social systems, physical infrastructure) using an epidemiological R-value model. Returns system R trajectory, per-epoch spread map, superspreader nodes, containment forecast, and AI briefing. R < 1.0 = self-limiting; R ≥ 1.0 = expanding. Call /contagion/nodes first to discover valid origin IDs. POST with origin and magnitude.
Parameters3
origin
string
optional
Origin node ID. Call intelligence.contagion with listNodes:true to discover valid IDs.
magnitude
number
optional
Initial shock magnitude 1–100.
listNodes
boolean
optional
If true, returns all valid origin node IDs instead of running a simulation.
Resonance Intelligence — detects when multiple independent macro forces are oscillating in phase across 28 signals in 5 domains, amplifying each other rather than cancelling. A single shock is manageable; resonance turns a bad quarter into a systemic crisis. Returns per-signal phase angles, resonance clusters (groups of 3+ aligned signals), amplitude amplification factor, system resonance score (0–100), and historical danger-zone comparison to crisis precedents (2008, 2011, 2020, 1997 EM). No input required — GET.
Gender Risk & Opportunity Intelligence — maps the structural relationship between GBV prevalence, legal discrimination, female labour force participation, and economic outcomes across 18 countries. Returns two independent scores: gbvRiskScore (0–100 suppression risk — high GBV → female LFPR suppression → GDP drag → fiscal stress → sovereign risk premium) and opportunityScore (0–100 reform upside — improving GBV indicators, closing LFPR gender gaps, and strengthening legal rights precede FDI inflows and consumer credit expansion). Five transmission mechanisms. Live FRED economic stress feedback. AI synthesis. Data: WHO GHO, World Bank WDI, FRED. 12h cache. No input required — GET.
FX Settlement Corridor Intelligence — per-pair execution risk assessment for 10 major currency corridors against USD: EUR, GBP, JPY, CAD, AUD, CHF, MXN, BRL, CNY, INR. Maps live FRED spot rates to settlement advice for each pair: SETTLE_NOW / SETTLE_WITH_HEDGE / DELAY_SHORT / DELAY_REVIEW / AVOID. Returns DXY dollar regime (STRONG_DOLLAR / NORMAL / WEAK_DOLLAR), regional block risk rollup (G4, Americas, Asia-Pacific), best corridors to settle through now, worst corridors to avoid or hedge, and recommended actions. Distinct from oracle.stability (which covers peg deviation and macro settlement gates) — this tool answers "which currency pairs are risky to settle through right now?" Data: FRED spot rates (DEXUSEU, DEXUSUK, DEXJPUS, etc.), DXY (DTWEXBGS). 1h cache.
Treasury Float Yield Routing Analysis — OPTIONAL, CLIENT-DIRECTED ONLY.
Analyzes whether idle settlement float can be productively deployed into a yield-bearing instrument between the current time and a scheduled settlement deadline. Returns a structured recommendation with expected yield, exit timing, liquidity assessment, slippage estimate, and a mandatory risk disclosure.
THIS TOOL DOES NOT MOVE FUNDS. It provides analysis only. All execution decisions are made by the client or agent acting on explicit instruction. DPX charges a flat fee for this analysis and does not receive any portion of yield earned.
Current supported instrument: sUSDS (Sky Protocol Savings Rate). Selected because:
• Instant on-chain entry and exit (no T+1 delays)
• No US person restrictions
• Real asset backing (tokenized RWAs + Spark borrow rates)
• Available on Base chain via bridge
• No de-peg events recorded (unlike synthetic alternatives)
Safety parameters enforced:
• Maximum 90% of settlement amount — 10% always stays in USDC
• Early exit triggered 30 minutes before settlement deadline (not 15)
• Slippage guard: if DEX USDC/USDS quote shows >0.1% slippage, recommendation = HOLD
• Minimum viable window: 2 hours (shorter windows do not justify entry/exit gas costs)
Not recommended if:
• Settlement window is < 2 hours
• Amount is < $50,000 (gas costs erode yield)
• Client has not acknowledged the risk_disclosure object in this response
• Settlement is time-critical with zero tolerance for delay
Parameters4
amountUsdc
number
required
Settlement amount in USDC. Minimum $50,000 for yield routing to be viable after gas costs.
settlementDeadlineUtc
string
required
ISO 8601 UTC timestamp of when USDC must be ready for settlement (e.g. "2026-06-15T20:00:00Z"). The tool will recommend exiting 30 minutes before this.
riskTolerance
string
optional
conservative = sUSDS only (T-bill / RWA backed, instant exit). moderate = sUSDS with higher slippage tolerance (up to 0.15%). Default: conservative.
dryRun
boolean
optional
If true, returns analysis without any on-chain queries. Useful for planning. Default: false.
Raw schema
{
"type": "object",
"properties": {
"amountUsdc": {
"type": "number",
"description": "Settlement amount in USDC. Minimum $50,000 for yield routing to be viable after gas costs."
},
"settlementDeadlineUtc": {
"type": "string",
"description": "ISO 8601 UTC timestamp of when USDC must be ready for settlement (e.g. \"2026-06-15T20:00:00Z\"). The tool will recommend exiting 30 minutes before this."
},
"riskTolerance": {
"type": "string",
"enum": [
"conservative",
"moderate"
],
"description": "conservative = sUSDS only (T-bill / RWA backed, instant exit). moderate = sUSDS with higher slippage tolerance (up to 0.15%). Default: conservative."
},
"dryRun": {
"type": "boolean",
"description": "If true, returns analysis without any on-chain queries. Useful for planning. Default: false."
}
},
"required": [
"amountUsdc",
"settlementDeadlineUtc"
]
}
mercury.accounts
List all Mercury bank accounts and balances connected to the DPX Settlement Agent. Returns account IDs, names, available balance, current balance, and currency for each account. Use account IDs with mercury.transactions to fetch payment history, or mercury.send to initiate a payment. Works with both Mercury sandbox and production environments.
List recent transactions for a Mercury bank account. Returns transaction ID, amount (USD), status, note/memo, counterparty name, created date, and whether the transaction was DPX-tagged (memo contains "dpx:"). Filter by account ID obtained from mercury.accounts. Use this to reconcile DPX settlements against Mercury bank activity.
Parameters3
accountId
string
required
Mercury account ID (from mercury.accounts).
limit
number
optional
Number of transactions to return (default 20, max 500).
Initiate a Mercury bank payment from a connected account. Supports all Mercury payment rails: ACH (0–1 days), Wire (0–1 days), Real-Time Payment / RTP (instant), International Wire (1–3 days), and Check (7–10 days).
For International Wire — the primary DPX cross-border use case — provide SWIFT/BIC code and beneficiary bank details. DPX oracle conditions and FX corridor risk should be checked via oracle.stability and market.fx before executing.
Can optionally tag the payment for automatic DPX on-chain routing — when dpxRoute:true is set, the payment memo includes the DPX executor wallet address and the Mercury webhook picks it up for USDC settlement on Base mainnet.
Use sandbox:true (default) for dry-run testing. Set sandbox:false only when ready to move real funds.
Typical cross-border flow:
1. market.fx → check FX corridor risk for the destination currency
2. mercury.accounts → get source accountId
3. mercury.send (sandbox:true) → confirm payment parameters
4. settlement.quote → get DPX fee quote for the USDC leg
5. mercury.send (sandbox:false) → execute (requires explicit user confirmation)
6. mercury.transactions → verify payment posted
Parameters21
accountId
string
required
Source Mercury account ID (from mercury.accounts).
Payment amount in USD (or destination currency if specified).
currency
string
optional
Destination currency for internationalWire (e.g. "GBP", "EUR"). Default USD.
note
string
optional
Payment memo / description.
dpxRoute
boolean
optional
If true, appends dpx:<wallet> to the memo — triggers DPX on-chain USDC settlement via the Mercury webhook. Use this to settle the stablecoin leg of a cross-border payment.
sandbox
boolean
optional
Dry run — returns what would be sent without executing. Default: true. Set false to execute.
recipientName
string
optional
Recipient legal name (required for ach/wire/rtp/check).
recipientEmail
string
optional
Recipient email (optional — for payment notification).
routingNumber
string
optional
Recipient routing number (required for ach/wire/check).
accountNumber
string
optional
Recipient account number (required for ach/wire/check). Also used for IBAN on internationalWire.
recipientId
string
optional
Mercury saved recipient ID for internationalWire. Use this if the recipient is already saved in Mercury — skips inline bank detail fields.
swiftCode
string
optional
BIC/SWIFT code of beneficiary bank (required for internationalWire without recipientId). E.g. "BARCGB22" for Barclays UK.
bankName
string
optional
Beneficiary bank name (e.g. "Barclays Bank UK PLC").
bankAddress
string
optional
Beneficiary bank street address.
bankCity
string
optional
Beneficiary bank city.
bankCountry
string
optional
Beneficiary bank country — ISO 3166-1 alpha-2 (e.g. "GB", "DE", "SG").
recipientAddress
string
optional
Beneficiary street address.
recipientCity
string
optional
Beneficiary city.
recipientCountry
string
optional
Beneficiary country — ISO 3166-1 alpha-2.
recipientPostalCode
string
optional
Beneficiary postal code.
Raw schema
{
"type": "object",
"properties": {
"accountId": {
"type": "string",
"description": "Source Mercury account ID (from mercury.accounts)."
},
"paymentMethod": {
"type": "string",
"enum": [
"ach",
"wire",
"rtp",
"internationalWire",
"check"
],
"description": "Payment rail. rtp = Real-Time Payment (instant, US domestic). internationalWire = cross-border (1–3 days). Default: ach."
},
"amount": {
"type": "number",
"description": "Payment amount in USD (or destination currency if specified)."
},
"currency": {
"type": "string",
"description": "Destination currency for internationalWire (e.g. \"GBP\", \"EUR\"). Default USD."
},
"note": {
"type": "string",
"description": "Payment memo / description."
},
"dpxRoute": {
"type": "boolean",
"description": "If true, appends dpx:<wallet> to the memo — triggers DPX on-chain USDC settlement via the Mercury webhook. Use this to settle the stablecoin leg of a cross-border payment."
},
"sandbox": {
"type": "boolean",
"description": "Dry run — returns what would be sent without executing. Default: true. Set false to execute."
},
"recipientName": {
"type": "string",
"description": "Recipient legal name (required for ach/wire/rtp/check)."
},
"recipientEmail": {
"type": "string",
"description": "Recipient email (optional — for payment notification)."
},
"routingNumber": {
"type": "string",
"description": "Recipient routing number (required for ach/wire/check)."
},
"accountNumber": {
"type": "string",
"description": "Recipient account number (required for ach/wire/check). Also used for IBAN on internationalWire."
},
"recipientId": {
"type": "string",
"description": "Mercury saved recipient ID for internationalWire. Use this if the recipient is already saved in Mercury — skips inline bank detail fields."
},
"swiftCode": {
"type": "string",
"description": "BIC/SWIFT code of beneficiary bank (required for internationalWire without recipientId). E.g. \"BARCGB22\" for Barclays UK."
},
"bankName": {
"type": "string",
"description": "Beneficiary bank name (e.g. \"Barclays Bank UK PLC\")."
},
"bankAddress": {
"type": "string",
"description": "Beneficiary bank street address."
},
"bankCity": {
"type": "string",
"description": "Beneficiary bank city."
},
"bankCountry": {
"type": "string",
"description": "Beneficiary bank country — ISO 3166-1 alpha-2 (e.g. \"GB\", \"DE\", \"SG\")."
},
"recipientAddress": {
"type": "string",
"description": "Beneficiary street address."
},
"recipientCity": {
"type": "string",
"description": "Beneficiary city."
},
"recipientCountry": {
"type": "string",
"description": "Beneficiary country — ISO 3166-1 alpha-2."
},
"recipientPostalCode": {
"type": "string",
"description": "Beneficiary postal code."
}
},
"required": [
"accountId",
"amount"
]
}
mercury.ach_authorize
Screen an ACH payment through the DPX compliance oracle before execution. Runs FATF R16, GENIUS Act, MiCA, and AML checks against the recipient. Returns APPROVED / FLAGGED / BLOCKED with full compliance reasoning.
Use this tool BEFORE every ACH payment via mercury.send. ACH is hard to reverse — compliance pre-screening prevents blocked transactions and BSA/AML exposure.
Workflow:
1. mercury.ach_authorize (screen only, autoExecute:false) → review decision
2. If APPROVED → set autoExecute:true to send, or call mercury.send directly
3. If FLAGGED → manual review required before proceeding
4. If BLOCKED → do not proceed
Parameters9
accountId
string
required
Source Mercury account ID (from mercury.accounts).
amount
number
required
Payment amount in USD.
recipientId
string
required
Mercury saved recipient ID (from mercury.send / POST /mercury/recipients).
recipientName
string
required
Legal name of the recipient entity or individual — used for compliance screening.
note
string
optional
Payment memo / note (optional).
externalMemo
string
optional
External memo / reference visible to recipient (optional).
purpose
string
optional
Payment purpose category (optional — required by Mercury for domesticWire, recommended for ACH). E.g. "Vendor", "Contractor", "Expenses".
idempotencyKey
string
optional
Idempotency key for safe retries. Auto-generated if omitted.
autoExecute
boolean
optional
If true and compliance returns APPROVED, immediately sends the ACH payment. Default false — screen first, execute separately.
Raw schema
{
"type": "object",
"properties": {
"accountId": {
"type": "string",
"description": "Source Mercury account ID (from mercury.accounts)."
},
"amount": {
"type": "number",
"description": "Payment amount in USD."
},
"recipientId": {
"type": "string",
"description": "Mercury saved recipient ID (from mercury.send / POST /mercury/recipients)."
},
"recipientName": {
"type": "string",
"description": "Legal name of the recipient entity or individual — used for compliance screening."
},
"note": {
"type": "string",
"description": "Payment memo / note (optional)."
},
"externalMemo": {
"type": "string",
"description": "External memo / reference visible to recipient (optional)."
},
"purpose": {
"type": "string",
"description": "Payment purpose category (optional — required by Mercury for domesticWire, recommended for ACH). E.g. \"Vendor\", \"Contractor\", \"Expenses\"."
},
"idempotencyKey": {
"type": "string",
"description": "Idempotency key for safe retries. Auto-generated if omitted."
},
"autoExecute": {
"type": "boolean",
"description": "If true and compliance returns APPROVED, immediately sends the ACH payment. Default false — screen first, execute separately."
}
},
"required": [
"accountId",
"amount",
"recipientId",
"recipientName"
]
}
mercury.sweep
Treasury float yield routing analysis for idle Mercury bank balances. Computes how much can be swept above a reserve threshold, then evaluates whether deploying into sUSDS (Sky Protocol Savings Rate) on Base is viable before a settlement deadline.
THIS TOOL DOES NOT MOVE FUNDS. It returns a structured recommendation with expected net yield, deployment amount, exit timing, and step-by-step execution instructions. All fund movement decisions remain with the client.
Safety rules enforced:
• Always keeps thresholdUsd in Mercury — never swept
• Maximum 90% of sweepable amount deployed to sUSDS
• Minimum 2-hour window required (shorter windows don't cover gas)
• Minimum $50,000 sweepable (below this, gas costs exceed yield)
• Exit triggered 30 minutes before settlement deadline
Current instrument: sUSDS (Sky Protocol) — instant on-chain entry/exit, ~6.25% APY, Base chain, no US person restrictions, no de-peg events on record.
Workflow:
1. mercury.accounts → get accountId and available balance
2. mercury.sweep → get yield recommendation and execution steps
3. If PROCEED → follow execution.steps to wire funds and deploy
4. mercury.accounts again at exit time → confirm balance restored
Parameters5
accountId
string
required
Mercury account ID to analyze (from mercury.accounts).
thresholdUsd
number
optional
Minimum USD balance to always keep in Mercury as a reserve. Sweepable = available balance minus this amount. Default: $50,000.
settlementDeadlineUtc
string
optional
ISO 8601 UTC timestamp of when funds must be back in Mercury (e.g. "2026-06-28T18:00:00Z"). Defaults to 7 days from now. Drives the yield window calculation.
If true, marks analysis as sandbox mode — Mercury balance may not reflect live state.
Raw schema
{
"type": "object",
"properties": {
"accountId": {
"type": "string",
"description": "Mercury account ID to analyze (from mercury.accounts)."
},
"thresholdUsd": {
"type": "number",
"description": "Minimum USD balance to always keep in Mercury as a reserve. Sweepable = available balance minus this amount. Default: $50,000."
},
"settlementDeadlineUtc": {
"type": "string",
"description": "ISO 8601 UTC timestamp of when funds must be back in Mercury (e.g. \"2026-06-28T18:00:00Z\"). Defaults to 7 days from now. Drives the yield window calculation."
},
"riskTolerance": {
"type": "string",
"enum": [
"conservative",
"moderate",
"aggressive"
],
"description": "Risk tolerance for yield deployment. Conservative requires APY > 5%. Default: moderate."
},
"sandbox": {
"type": "boolean",
"description": "If true, marks analysis as sandbox mode — Mercury balance may not reflect live state."
}
},
"required": [
"accountId"
]
}
swift.gpi_track
Track a DPX settlement via SWIFT gpi-compatible status. Given a UETR (Unique End-to-End Transaction Reference), returns gpi-format payment status including pacs.002 payload that a SWIFT member bank can submit to the gpi Tracker.
Use this when a UETR was provided at payment initiation (via the uetr field in settlement.execute or POST /payments/initiate). Returns ACCP (settled), PDNG (pending), or RJCT (rejected) with full on-chain settlement details.
DPX is not a SWIFT member — the SWIFT member bank submits the returned pacs.002 to the gpi Tracker via their own gpi API access.
Parameters1
uetr
string
required
RFC 4122 UUID UETR assigned at payment initiation, e.g. "97ed4827-7b6f-4491-a06f-b548d5a7512d".
Create a spending policy for an AI agent. Sets rules the agent must follow before any financial action: per-transaction ceiling, daily limit, hold threshold, blocked counterparties, allowed purposes, oracle stability gate. Once set, every payment by this agent is checked against the policy automatically via policy.check.
Parameters9
agent_id
string
required
Stable identifier for the agent or org (wallet address, session prefix, org slug, etc.)
name
string
required
Human-readable policy name
max_per_tx
number
optional
USD ceiling per single transaction. Payments above this are BLOCKED.
max_per_day
number
optional
USD rolling daily ceiling. Payments that would exceed this are HOLDed.
require_hold_above
number
optional
Route to HOLD queue for human review if amount exceeds this threshold.
blocked_regions
array
optional
ISO 3166-1 alpha-2 country codes to block.
blocked_counterparties
array
optional
Wallet addresses or LEIs to block.
allowed_purposes
array
optional
If set, only payments with a purpose in this list are allowed.
require_oracle_stable
boolean
optional
If true, HOLD on CAUTION as well as UNSTABLE oracle status.
Raw schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"description": "Stable identifier for the agent or org (wallet address, session prefix, org slug, etc.)"
},
"name": {
"type": "string",
"description": "Human-readable policy name"
},
"max_per_tx": {
"type": "number",
"description": "USD ceiling per single transaction. Payments above this are BLOCKED."
},
"max_per_day": {
"type": "number",
"description": "USD rolling daily ceiling. Payments that would exceed this are HOLDed."
},
"require_hold_above": {
"type": "number",
"description": "Route to HOLD queue for human review if amount exceeds this threshold."
},
"blocked_regions": {
"type": "array",
"items": {
"type": "string"
},
"description": "ISO 3166-1 alpha-2 country codes to block."
},
"blocked_counterparties": {
"type": "array",
"items": {
"type": "string"
},
"description": "Wallet addresses or LEIs to block."
},
"allowed_purposes": {
"type": "array",
"items": {
"type": "string"
},
"description": "If set, only payments with a purpose in this list are allowed."
},
"require_oracle_stable": {
"type": "boolean",
"description": "If true, HOLD on CAUTION as well as UNSTABLE oracle status."
}
},
"required": [
"agent_id",
"name"
]
}
policy.check
Check a proposed payment against the agent's active policy before executing it. Returns ALLOW, HOLD, or BLOCK with a reason. Run this before every settlement call. ALLOW = proceed. HOLD = route to human review queue. BLOCK = halt, do not proceed.
Parameters9
agent_id
string
required
Agent identifier — must match the agent_id used in policy.create
amount_usd
number
required
Proposed payment amount in USD
to_currency
string
optional
Destination currency code (e.g. EUR, GBP)
recipient
string
optional
Recipient wallet address
counterparty
string
optional
Counterparty name or LEI
purpose
string
optional
Payment purpose string
oracle_status
string
optional
Current oracle status — STABLE, CAUTION, or UNSTABLE. Get from get_reliability.
delegation_id
string
optional
If acting under a delegation from a parent agent, provide the delegation ID.
session_id
string
optional
Task or session grouping ID for ledger tracking.
Raw schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"description": "Agent identifier — must match the agent_id used in policy.create"
},
"amount_usd": {
"type": "number",
"description": "Proposed payment amount in USD"
},
"to_currency": {
"type": "string",
"description": "Destination currency code (e.g. EUR, GBP)"
},
"recipient": {
"type": "string",
"description": "Recipient wallet address"
},
"counterparty": {
"type": "string",
"description": "Counterparty name or LEI"
},
"purpose": {
"type": "string",
"description": "Payment purpose string"
},
"oracle_status": {
"type": "string",
"description": "Current oracle status — STABLE, CAUTION, or UNSTABLE. Get from get_reliability."
},
"delegation_id": {
"type": "string",
"description": "If acting under a delegation from a parent agent, provide the delegation ID."
},
"session_id": {
"type": "string",
"description": "Task or session grouping ID for ledger tracking."
}
},
"required": [
"agent_id",
"amount_usd"
]
}
policy.delegate
Delegate payment authority from a parent agent to a sub-agent with explicit limits. The sub-agent can only spend up to the delegated ceiling. Delegation can be revoked at any time. Use in multi-agent workflows where an orchestrator authorises a worker agent to make payments on its behalf.
Parameters6
parent_agent_id
string
required
The authorising (parent) agent ID
child_agent_id
string
required
The sub-agent receiving delegated authority
policy_id
string
optional
Policy ID to inherit (optional — inherits parent policy if omitted)
max_per_tx
number
optional
Maximum USD per transaction for the sub-agent
max_total
number
optional
Lifetime spending ceiling for this delegation
expires_at
number
optional
Unix timestamp (ms) when this delegation expires. Omit for no expiry.
Raw schema
{
"type": "object",
"properties": {
"parent_agent_id": {
"type": "string",
"description": "The authorising (parent) agent ID"
},
"child_agent_id": {
"type": "string",
"description": "The sub-agent receiving delegated authority"
},
"policy_id": {
"type": "string",
"description": "Policy ID to inherit (optional — inherits parent policy if omitted)"
},
"max_per_tx": {
"type": "number",
"description": "Maximum USD per transaction for the sub-agent"
},
"max_total": {
"type": "number",
"description": "Lifetime spending ceiling for this delegation"
},
"expires_at": {
"type": "number",
"description": "Unix timestamp (ms) when this delegation expires. Omit for no expiry."
}
},
"required": [
"parent_agent_id",
"child_agent_id"
]
}
receipt.create
Record a tamper-evident signed receipt for an agent financial action. Call immediately after every successful settlement. Returns a receipt ID and HMAC-SHA256 signature over the canonical receipt JSON — cryptographic proof the record has not been altered. Receipts are queryable by session or agent for audit.
Parameters15
agent_id
string
required
Agent that executed the payment
session_id
string
optional
Task or session ID for grouping (use the same ID for all payments in one agent run)
task_context
string
optional
Plain-text description of what task triggered this payment
amount_usd
number
required
Amount paid in USD
from_currency
string
optional
Source currency (default: USD)
to_currency
string
optional
Destination currency (default: USD)
recipient
string
optional
Recipient wallet address
counterparty
string
optional
Counterparty name
oracle_status
string
optional
Oracle status at time of payment (STABLE / CAUTION / UNSTABLE)
compliance_decision
string
optional
Compliance decision at time of payment (PROCEED / HOLD / BLOCKED)
settlement_id
string
optional
Settlement ID returned by the settle tool
tx_hash
string
optional
On-chain transaction hash (if live)
policy_id
string
optional
Policy ID that governed this payment
delegation_id
string
optional
Delegation ID if acting under delegated authority
sandbox
boolean
optional
True if this was a sandbox settlement
Raw schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"description": "Agent that executed the payment"
},
"session_id": {
"type": "string",
"description": "Task or session ID for grouping (use the same ID for all payments in one agent run)"
},
"task_context": {
"type": "string",
"description": "Plain-text description of what task triggered this payment"
},
"amount_usd": {
"type": "number",
"description": "Amount paid in USD"
},
"from_currency": {
"type": "string",
"description": "Source currency (default: USD)"
},
"to_currency": {
"type": "string",
"description": "Destination currency (default: USD)"
},
"recipient": {
"type": "string",
"description": "Recipient wallet address"
},
"counterparty": {
"type": "string",
"description": "Counterparty name"
},
"oracle_status": {
"type": "string",
"description": "Oracle status at time of payment (STABLE / CAUTION / UNSTABLE)"
},
"compliance_decision": {
"type": "string",
"description": "Compliance decision at time of payment (PROCEED / HOLD / BLOCKED)"
},
"settlement_id": {
"type": "string",
"description": "Settlement ID returned by the settle tool"
},
"tx_hash": {
"type": "string",
"description": "On-chain transaction hash (if live)"
},
"policy_id": {
"type": "string",
"description": "Policy ID that governed this payment"
},
"delegation_id": {
"type": "string",
"description": "Delegation ID if acting under delegated authority"
},
"sandbox": {
"type": "boolean",
"description": "True if this was a sandbox settlement"
}
},
"required": [
"agent_id",
"amount_usd"
]
}
ledger.session
Get the aggregated payment graph for a multi-agent session. Returns total USD moved, transaction count, and a chronological list of all payments made during the session. Use for cost accounting, audit, or to show a human what an agent run spent.
Parameters1
session_id
string
required
Session or task ID — the same ID used in receipt.create calls
Raw schema
{
"type": "object",
"properties": {
"session_id": {
"type": "string",
"description": "Session or task ID — the same ID used in receipt.create calls"
}
},
"required": [
"session_id"
]
}
search_docs
Search DPX documentation by keyword. Returns the most relevant doc sections — including how-to guides, API references, fee structure, oracle architecture, compliance requirements, and integration setup. Call this when you need protocol details mid-task rather than relying on context alone. Free.
Parameters2
query
string
required
Keywords to search — e.g. "how to settle", "esg fee formula", "butterfly cascade", "mercury send", "compliance screen".
limit
number
optional
Max results to return (default 3, max 5).
Raw schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Keywords to search — e.g. \"how to settle\", \"esg fee formula\", \"butterfly cascade\", \"mercury send\", \"compliance screen\"."
},
"limit": {
"type": "number",
"description": "Max results to return (default 3, max 5)."
}
},
"required": [
"query"
]
}
compute.models
List all AI models available through DPX Compute. All models are free-tier (no token cost) — routed via OpenRouter. Returns model IDs, provider, capability strengths, context window, and speed tier. Use this before compute.route to understand what models are available and pick the right one for a task. Free.
Get a model recommendation for a task type without running inference. Returns the best free model for the task, its strengths and speed tier, and a list of alternatives. Use this when an agent needs to select a model before committing to inference, or to surface model selection logic to a human. Free.
Parameters2
task
string
required
Description of the task — e.g. "summarize a financial document", "write Python code", "translate from French", "reason through a math problem".
speed
boolean
optional
true = prefer fastest model over most capable. Default false.
Raw schema
{
"type": "object",
"properties": {
"task": {
"type": "string",
"description": "Description of the task — e.g. \"summarize a financial document\", \"write Python code\", \"translate from French\", \"reason through a math problem\"."
},
"speed": {
"type": "boolean",
"description": "true = prefer fastest model over most capable. Default false."
}
},
"required": [
"task"
]
}
compute.route
Route a task to the best available free AI model and run inference. DPX selects the model based on the task type (reasoning → DeepSeek R1, code → Llama 3.3 70B, multilingual → Qwen 2.5 72B, fast → Llama 3.1 8B), calls OpenRouter, and returns the completion. All models are free-tier — no token cost. Pay per call in USDC via x402. Use this when an agent needs to delegate a subtask to a language model without managing model selection or API keys.
Parameters3
task
string
required
Plain-language description of what the model should do. Used for model selection.
messages
array
optional
Optional. Full message array in OpenAI format [{role, content}]. If omitted, task is sent as a user message.
preferSpeed
boolean
optional
true = use the fastest available free model regardless of task type. Default false.
Raw schema
{
"type": "object",
"properties": {
"task": {
"type": "string",
"description": "Plain-language description of what the model should do. Used for model selection."
},
"messages": {
"type": "array",
"description": "Optional. Full message array in OpenAI format [{role, content}]. If omitted, task is sent as a user message."
},
"preferSpeed": {
"type": "boolean",
"description": "true = use the fastest available free model regardless of task type. Default false."
}
},
"required": [
"task"
]
}
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 - 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
npx @smithery/cli install @untitledfinancial/dpx-mcp --client claude
Example flows
AI agent settlement workflow:
code
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):
code
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.
