Server definition
- Hash
- sha256:c5ad0866d9bce258e44b0d62537ee201851953d5dca4dd6ca645b8861cab1d0a
- What it is
- What a remote MCP server returned when asked what it offers: 115 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "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.",
"inputSchema": {
"properties": {
"framework": {
"description": "Agent framework: \"claude\", \"gpt-4o\", \"gemini\", \"custom\", etc.",
"type": "string"
},
"mandate": {
"description": "Optional AP2-compatible spend mandate (REGISTERED/VERIFIED only). Caps are clamped to tier limits for REGISTERED agents.",
"properties": {
"counterpartyWhitelist": {
"description": "LEIs or wallet addresses (empty = any).",
"items": {
"type": "string"
},
"type": "array"
},
"currencyPairs": {
"description": "e.g. [\"USD|EUR\"] (empty = any).",
"items": {
"type": "string"
},
"type": "array"
},
"dailyCapUsd": {
"description": "Max USD per calendar day (UTC).",
"type": "number"
},
"esgFloor": {
"description": "Minimum counterparty ESG score (0 = no floor).",
"type": "number"
},
"expiresAt": {
"description": "Unix timestamp for mandate expiry.",
"type": "number"
},
"maxNotionalUsd": {
"description": "Max USD per single settlement.",
"type": "number"
}
},
"type": "object"
},
"name": {
"description": "Human-readable name for this agent.",
"type": "string"
},
"ownerEmail": {
"description": "Contact email. Required for REGISTERED tier ($25K/day cap). Self-attested, not verified.",
"type": "string"
},
"ownerEntity": {
"description": "Organization or person that owns/operates this agent. Required for REGISTERED tier.",
"type": "string"
},
"ownerLei": {
"description": "20-char GLEIF LEI. Providing a valid active LEI instantly grants VERIFIED tier — no documents. Get your LEI at gleif.org.",
"type": "string"
},
"protocols": {
"description": "Supported protocols: [\"x402\", \"ap2\", \"mcp\", \"a2a\"].",
"items": {
"type": "string"
},
"type": "array"
},
"publicKey": {
"description": "Optional public key for credential signature verification.",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "agent.kya_register",
"outputSchema": {
"properties": {
"agentId": {
"description": "Unique agent identifier (agt_...). Store this.",
"type": "string"
},
"kyaLevel": {
"enum": [
"ANONYMOUS",
"REGISTERED",
"VERIFIED"
],
"type": "string"
},
"kyaScore": {
"description": "Trust score 0–100.",
"type": "number"
},
"leiEntityName": {
"description": "Legal name from GLEIF record (VERIFIED only).",
"type": "string"
},
"leiVerified": {
"description": "true if LEI was confirmed via GLEIF API.",
"type": "boolean"
},
"tierCaps": {
"description": "maxNotionalUsd and dailyCapUsd effective for this agent.",
"type": "object"
},
"tierNote": {
"description": "Explanation of tier and how to upgrade.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"agentId": {
"description": "Agent ID from agent.kya_register (agt_...).",
"type": "string"
}
},
"required": [
"agentId"
],
"type": "object"
},
"name": "agent.kya_verify",
"outputSchema": {
"properties": {
"credential": {
"description": "agentId, issuedAt, expiresAt, mandateId, attestation (kyaLevel, ownerVerified, mandateActive, fatfCompliant, dailyCapUsd, maxNotionalUsd), signature",
"type": "object"
},
"kyaLevel": {
"type": "string"
},
"kyaScore": {
"type": "number"
},
"mandate": {
"description": "Active mandate if present, null if expired.",
"type": "object"
},
"verified": {
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"agentId": {
"description": "Agent ID from agent.kya_register.",
"type": "string"
},
"counterpartyWhitelist": {
"description": "LEIs or wallet addresses. Empty = any counterparty.",
"items": {
"type": "string"
},
"type": "array"
},
"currencyPairs": {
"description": "Allowed pairs e.g. [\"USD|EUR\"]. Empty = any pair.",
"items": {
"type": "string"
},
"type": "array"
},
"dailyCapUsd": {
"description": "Max USD per calendar day (UTC).",
"type": "number"
},
"esgFloor": {
"description": "Min counterparty ESG score (0 = no floor).",
"type": "number"
},
"expiresAt": {
"description": "Unix timestamp for mandate expiry.",
"type": "number"
},
"issuedBy": {
"description": "Organization issuing this mandate.",
"type": "string"
},
"maxNotionalUsd": {
"description": "Max USD per single settlement.",
"type": "number"
}
},
"required": [
"agentId",
"maxNotionalUsd",
"dailyCapUsd"
],
"type": "object"
},
"name": "agent.mandate_create",
"outputSchema": {
"properties": {
"agentId": {
"type": "string"
},
"ap2Compatible": {
"type": "boolean"
},
"effectiveCaps": {
"description": "Actual caps after tier clamping.",
"type": "object"
},
"mandate": {
"description": "Full mandate object.",
"type": "object"
},
"mandateId": {
"description": "Unique mandate ID (mnd_...).",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "analytics.overview",
"outputSchema": {
"properties": {
"esgScore": {
"description": "Protocol ESG composite score 0–100",
"type": "number"
},
"fees": {
"properties": {
"baseRatePct": {
"type": "number"
},
"esgFeePct": {
"type": "number"
},
"totalPct": {
"type": "number"
}
},
"type": "object"
},
"oracleHealth": {
"additionalProperties": true,
"description": "Health status per oracle data source",
"type": "object"
},
"settlementReady": {
"description": "True if conditions are suitable for settlement",
"type": "boolean"
},
"stabilityScore": {
"description": "Current oracle stability score 0–100",
"type": "number"
},
"timestamp": {
"description": "ISO 8601 analytics timestamp",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"settlements": {
"description": "Array of settlement request objects (same schema as the settle tool)",
"items": {
"properties": {
"amount": {
"type": "number"
},
"destinationCurrency": {
"type": "string"
},
"recipientAddress": {
"type": "string"
},
"sandbox": {
"type": "boolean"
},
"sourceCurrency": {
"type": "string"
},
"token": {
"type": "string"
}
},
"required": [
"amount",
"sourceCurrency",
"destinationCurrency",
"recipientAddress"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
}
},
"required": [
"settlements"
],
"type": "object"
},
"name": "batch_settle",
"outputSchema": {
"properties": {
"results": {
"items": {
"properties": {
"data": {
"additionalProperties": true,
"type": "object"
},
"index": {
"type": "number"
},
"status": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
},
"summary": {
"properties": {
"failed": {
"type": "number"
},
"succeeded": {
"type": "number"
},
"total": {
"type": "number"
}
},
"type": "object"
}
},
"type": "object"
}
},
{
"description": "Plan treasury settlement for a crypto card program. Accepts net positions per corridor (e.g. USD-BRL: $2.3M, USD-EUR: €450K) and returns an optimal settlement plan — which corridors to settle now vs. hold, which stablecoin to use per corridor, and estimated all-in fee. No settlement is executed. Call this before card.settle to review the plan. Free.",
"inputSchema": {
"properties": {
"positions": {
"description": "Array of net positions. Each: { corridor: \"USD-BRL\", netAmountUsd: 2300000, recipientAddress?: \"0x...\" }",
"items": {
"type": "object"
},
"type": "array"
},
"settlementDate": {
"description": "Settlement date ISO string (defaults to today UTC). E.g. \"2026-08-09\".",
"type": "string"
}
},
"required": [
"positions"
],
"type": "object"
},
"name": "card.positions",
"outputSchema": null
},
{
"description": "Execute treasury settlement for a crypto card program. Takes the same positions array as card.positions but executes all settlements via DPX batch — compliance-gated, oracle-priced, stablecoin-routed. Each position requires a recipientAddress. Use sandbox:true for testing. Returns per-corridor settlement results and a summary.",
"inputSchema": {
"properties": {
"positions": {
"description": "Array of net positions. Each: { corridor: \"USD-BRL\", netAmountUsd: 2300000, recipientAddress: \"0x...\" }. recipientAddress is required for every position.",
"items": {
"type": "object"
},
"type": "array"
},
"sandbox": {
"description": "true = test mode, no on-chain execution. Default true — set false only for live execution.",
"type": "boolean"
}
},
"required": [
"positions"
],
"type": "object"
},
"name": "card.settle",
"outputSchema": null
},
{
"description": "AML Screen with Behavioural Profiling — deep AML assessment combining sanctions matching (OFAC, EU, UN, OFSI), behavioural pattern analysis, transaction velocity signals, and counterparty network risk. Returns CLEAR / REVIEW / BLOCK decision with confidence score, matched sanctions lists, behavioural anomaly flags, and a structured compliance narrative for audit. Use for high-value payments, onboarding, or any counterparty flagged by flow_check. Accepts wallet address or entity identifier. x402 paid, USDC on Base.",
"inputSchema": {
"properties": {
"amountUsd": {
"description": "Transaction amount — used for velocity profiling. Optional.",
"type": "number"
},
"entity": {
"description": "Wallet address, LEI, or name of the counterparty to screen.",
"type": "string"
},
"purpose": {
"description": "Payment purpose — used for behavioural context. Optional.",
"type": "string"
}
},
"required": [
"entity"
],
"type": "object"
},
"name": "compliance.aml_screen",
"outputSchema": {
"properties": {
"behavioural": {
"description": "Velocity flags, counterparty network risk, anomaly signals.",
"type": "object"
},
"confidence": {
"description": "Decision confidence 0–1.",
"type": "number"
},
"decision": {
"description": "CLEAR / REVIEW / BLOCK",
"type": "string"
},
"narrative": {
"description": "Structured compliance narrative for audit record.",
"type": "string"
},
"sanctionHits": {
"description": "Matched sanctions list entries with list name and match score.",
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"country": {
"description": "ISO-2 country code to narrow the search (e.g. \"IT\"). Optional.",
"type": "string"
},
"q": {
"description": "Full name to screen (e.g. \"Mario Draghi\").",
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "compliance.pep_screen",
"outputSchema": {
"properties": {
"fatfCompliance": {
"description": "EDD required flag, FATF R.12/13 attestation, note",
"type": "object"
},
"matched": {
"type": "boolean"
},
"matches": {
"description": "Per match: caption, datasets, position, nationality, birthDate, relatedEntities, riskLevel, matchScore",
"type": "array"
},
"overallRisk": {
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"NONE"
],
"type": "string"
},
"totalMatches": {
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "compliance.regulatory_calendar",
"outputSchema": {
"properties": {
"dpxAlignment": {
"description": "Per-framework mapping to DPX endpoints that satisfy each obligation",
"type": "object"
},
"inEffect": {
"description": "Currently active requirements, most recent first",
"type": "array"
},
"upcoming": {
"description": "Events not yet in effect, sorted by effective date ascending",
"type": "array"
}
},
"type": "object"
}
},
{
"description": "SFDR Annex I PAI Report — generates the full Principal Adverse Impact statement for a portfolio of up to 50 entities (by LEI or wallet address). Returns all 18 mandatory indicators plus 2 optional climate indicators in the SFDR Annex I table format. Required for SFDR Article 8 and Article 9 product annual disclosure. Accepts LEIs or company names (GLEIF-resolved). x402 paid, USDC on Base.",
"inputSchema": {
"properties": {
"entities": {
"description": "LEIs, wallet addresses, or company names. Max 50.",
"items": {
"type": "string"
},
"type": "array"
},
"reportDate": {
"description": "ISO date for the report reference period (default: today).",
"type": "string"
}
},
"required": [
"entities"
],
"type": "object"
},
"name": "compliance.sfdr_pai_report",
"outputSchema": {
"properties": {
"paiTable": {
"description": "SFDR Annex I table rows — indicator, value, unit, data source, coverage.",
"type": "array"
},
"portfolioScore": {
"description": "Aggregate PAI composite score 0–100.",
"type": "number"
},
"synthesis": {
"description": "Narrative for the PAI statement.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "SFDR Article 8/9 Compliance Screen — determines whether a financial product or counterparty meets the Sustainable Finance Disclosure Regulation classification thresholds. Returns Article classification (6/8/9), Principal Adverse Impact indicator flags across 18 mandatory PAI metrics, ESG score alignment, and DNSH (Do No Significant Harm) assessment. Required for EU-regulated funds and any payment counterparty with SFDR disclosure obligations. Pass LEI or wallet address. x402 paid, USDC on Base.",
"inputSchema": {
"properties": {
"articleTarget": {
"description": "Target SFDR article classification to assess against. Default: \"8\".",
"enum": [
"6",
"8",
"9"
],
"type": "string"
},
"entity": {
"description": "LEI or wallet address of the entity to screen.",
"type": "string"
}
},
"required": [
"entity"
],
"type": "object"
},
"name": "compliance.sfdr_screen",
"outputSchema": {
"properties": {
"classification": {
"description": "Article 6 / 8 / 9 classification result.",
"type": "string"
},
"dnsh": {
"description": "Do No Significant Harm assessment across 6 environmental objectives.",
"type": "object"
},
"paiFlags": {
"description": "18 mandatory PAI indicators with flag, value, threshold, and pass/fail.",
"type": "array"
},
"synthesis": {
"description": "Plain-language SFDR compliance narrative.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"deep": {
"description": "Set true to attempt 3-level traversal including intermediate nodes. Default false (direct + ultimate parent only).",
"type": "boolean"
},
"lei": {
"description": "20-character GLEIF LEI of the entity to trace (e.g. \"2594007XIACKNMUAW223\").",
"type": "string"
}
},
"required": [
"lei"
],
"type": "object"
},
"name": "compliance.ubo_chain",
"outputSchema": {
"properties": {
"chain": {
"description": "Per-node: level, role, lei, entityName, country, leiStatus, sanctions (matched, score, datasets), riskFlag",
"type": "array"
},
"chainDepth": {
"type": "number"
},
"fatfR16": {
"description": "FATF R.16 beneficial ownership compliance attestation",
"type": "object"
},
"overallStatus": {
"enum": [
"CLEAR",
"REVIEW_REQUIRED",
"BLOCKED"
],
"type": "string"
},
"riskFlags": {
"description": "Nodes with sanctions hits or lapsed LEIs",
"type": "array"
},
"ultimateBeneficialOwner": {
"description": "lei, entityName, country, leiStatus of the UBO",
"type": "object"
}
},
"type": "object"
}
},
{
"description": "Composite Vendor Risk Score — combines compliance (65%) and ESG (35%) signals into a single vendor risk assessment. Returns an overall risk tier (LOW / MEDIUM / HIGH / CRITICAL), component breakdown, sanctions status, PEP flags, ESG pillar scores, and a payment recommendation (PROCEED / PROCEED_WITH_MONITORING / HOLD / BLOCK). Designed for pre-payment vendor due diligence, treasury onboarding, and supplier risk review. Accepts LEI or wallet address. x402 paid, USDC on Base.",
"inputSchema": {
"properties": {
"amountUsd": {
"description": "Payment amount in USD — scales the risk threshold (larger payments trigger higher scrutiny). Optional.",
"type": "number"
},
"entity": {
"description": "LEI, wallet address, or company name of the vendor.",
"type": "string"
}
},
"required": [
"entity"
],
"type": "object"
},
"name": "compliance.vendor_risk",
"outputSchema": {
"properties": {
"complianceScore": {
"description": "AML/sanctions/PEP composite 0–100.",
"type": "number"
},
"esgScore": {
"description": "ESG composite 0–100.",
"type": "number"
},
"flags": {
"description": "Active risk flags with severity and source.",
"type": "array"
},
"recommendation": {
"description": "PROCEED / PROCEED_WITH_MONITORING / HOLD / BLOCK",
"type": "string"
},
"riskTier": {
"description": "LOW / MEDIUM / HIGH / CRITICAL",
"type": "string"
},
"synthesis": {
"description": "Plain-language vendor risk narrative.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Verification of Payee — cryptographically verified payee check before a cross-border payment. Resolves a wallet address against GLEIF LEI registry, ESG Oracle, and on-chain activity to confirm the payee is who they claim to be. Returns a verification attestation, match confidence score, identity fields confirmed, and a signed verification receipt. Required for FATF R16 Travel Rule compliance and recommended for any payment over $3,000. $0.075 USDC per verification.",
"inputSchema": {
"properties": {
"expectedLei": {
"description": "Expected LEI for exact-match verification. Optional.",
"type": "string"
},
"expectedName": {
"description": "Expected legal entity name for name-match verification. Optional.",
"type": "string"
},
"walletAddress": {
"description": "Payee wallet address to verify.",
"type": "string"
}
},
"required": [
"walletAddress"
],
"type": "object"
},
"name": "compliance.vop_verify",
"outputSchema": {
"properties": {
"attestation": {
"description": "Signed verification receipt for audit.",
"type": "string"
},
"confidence": {
"description": "Match confidence 0–1.",
"type": "number"
},
"identityFields": {
"description": "Confirmed fields: lei, entityName, jurisdiction, esgTier.",
"type": "object"
},
"verified": {
"description": "True if payee identity confirmed.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"speed": {
"description": "true = prefer fastest model over most capable. Default false.",
"type": "boolean"
},
"task": {
"description": "Description of the task — e.g. \"summarize a financial document\", \"write Python code\", \"translate from French\", \"reason through a math problem\".",
"type": "string"
}
},
"required": [
"task"
],
"type": "object"
},
"name": "compute.cost",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "compute.models",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"messages": {
"description": "Optional. Full message array in OpenAI format [{role, content}]. If omitted, task is sent as a user message.",
"type": "array"
},
"preferSpeed": {
"description": "true = use the fastest available free model regardless of task type. Default false.",
"type": "boolean"
},
"task": {
"description": "Plain-language description of what the model should do. Used for model selection.",
"type": "string"
}
},
"required": [
"task"
],
"type": "object"
},
"name": "compute.route",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"amount": {
"description": "Payment amount in USD as shown on screen",
"type": "number"
},
"counterparty_name": {
"description": "Vendor or payee name as shown on screen",
"type": "string"
},
"purpose": {
"description": "Payment purpose — e.g. vendor-invoice, contractor-payment, subscription, procurement",
"type": "string"
},
"recipient_address": {
"description": "Recipient wallet address (0x...). If only bank/email visible, use settlement.nl instead.",
"type": "string"
},
"sandbox": {
"description": "Set false for live execution. Default: true",
"type": "boolean"
},
"screen_context": {
"description": "Describe what is visible on screen — the payment form, vendor name, invoice number, or UI context. Used for audit trail.",
"type": "string"
}
},
"required": [
"screen_context",
"amount",
"recipient_address",
"purpose"
],
"type": "object"
},
"name": "computer_use.pay",
"outputSchema": {
"properties": {
"aiConfidence": {
"type": "number"
},
"aiDecision": {
"type": "string"
},
"decision": {
"enum": [
"EXECUTED",
"ABORTED",
"HOLD",
"BLOCKED"
],
"type": "string"
},
"feeUsd": {
"type": "number"
},
"netUsd": {
"type": "number"
},
"reason": {
"type": "string"
},
"settlementId": {
"type": "string"
},
"status": {
"type": "string"
},
"txHash": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "A 39-term DeFi/digital-currency glossary spanning fundamentals, blockchain, tokens/assets, protocols, governance, security, and regulatory terms (fiat, TVL, AMM, DAO, impermanent loss, MiCA, and more), sourced from the World Economic Forum glossary plus DPX-curated DeFi infrastructure definitions. Optional keyword filter.",
"inputSchema": {
"properties": {
"q": {
"description": "Optional keyword filter across term, definition, and category (e.g. \"collateral\", \"governance\").",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "defi.concept_lookup",
"outputSchema": {
"properties": {
"count": {
"type": "number"
},
"label": {
"type": "string"
},
"records": {
"description": "Per term: id, term, definition, category, source",
"type": "array"
}
},
"type": "object"
}
},
{
"description": "13 structured institutional research papers on CBDCs, stablecoins, crypto regulation, and cross-border payments — from BIS, the Federal Reserve, ECB, FSB, IMF, G7, SWIFT, and R3 — each with a summary and key findings. These papers are free but otherwise scattered as individual PDFs with no query layer; this makes them queryable in one place. Optional keyword filter.",
"inputSchema": {
"properties": {
"q": {
"description": "Optional keyword filter across title, organization, summary, and category (e.g. \"mBridge\", \"reserve\").",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "defi.research_papers",
"outputSchema": {
"properties": {
"count": {
"type": "number"
},
"label": {
"type": "string"
},
"records": {
"description": "Per paper: id, title, author, organization, date, category, summary, key_findings, source",
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"window": {
"description": "Time window for metrics. \"7d\" = last 7 days, \"30d\" = last 30 days. Default: 30d.",
"enum": [
"7d",
"30d"
],
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "dpx.metrics",
"outputSchema": {
"properties": {
"dailyAverage": {
"type": "number"
},
"errorRate": {
"type": "string"
},
"peakDay": {
"type": "object"
},
"services": {
"type": "array"
},
"summary": {
"type": "string"
},
"totalRequests": {
"type": "number"
},
"weeklyTrend": {
"type": "array"
},
"window": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"leis": {
"description": "Array of LEIs to screen (fastest path — no GLEIF resolution needed).",
"items": {
"type": "string"
},
"type": "array"
},
"names": {
"description": "Array of company names to screen (resolved via GLEIF — slower, allows ≤3s per name).",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [],
"type": "object"
},
"name": "esg.batch",
"outputSchema": {
"properties": {
"failed": {
"type": "number"
},
"results": {
"description": "Entities sorted by composite score descending. Each item includes lei, entityName, score object, or an error note.",
"type": "array"
},
"succeeded": {
"type": "number"
},
"total": {
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"country": {
"description": "ISO-2 country code to narrow results (e.g. \"US\", \"DE\"). Optional but improves match accuracy.",
"type": "string"
},
"narrate": {
"description": "Set true to include a 2–3 sentence plain-English compliance narrative generated by the AI synthesis layer.",
"type": "boolean"
},
"q": {
"description": "Company name, domain, or ticker to look up (e.g. \"Apple Inc\", \"siemens.com\", \"MSFT\")",
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "esg.lookup",
"outputSchema": {
"properties": {
"found": {
"type": "boolean"
},
"narration": {
"description": "Plain-language compliance narrative (only when narrate=true)",
"type": "string"
},
"resolved": {
"properties": {
"country": {
"type": "string"
},
"entityName": {
"type": "string"
},
"lei": {
"type": "string"
},
"leiStatus": {
"type": "string"
}
},
"type": "object"
},
"score": {
"description": "Full ESG score object with composite, environmental, social, governance, feeTier, feeSurcharge, sources, coverage",
"type": "object"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"label": {
"description": "Optional label for this portfolio (e.g. \"Q3 2026 Counterparties\").",
"type": "string"
},
"leis": {
"description": "LEIs to score (fastest — no name resolution).",
"items": {
"type": "string"
},
"type": "array"
},
"names": {
"description": "Company names to score (GLEIF-resolved).",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [],
"type": "object"
},
"name": "esg.portfolio",
"outputSchema": {
"properties": {
"compliance": {
"description": "micaArticle72, highRiskCount, sfdr flags",
"type": "object"
},
"distribution": {
"description": "byTier counts, min, max, median",
"type": "object"
},
"entities": {
"properties": {
"failed": {
"type": "number"
},
"scored": {
"type": "number"
},
"total": {
"type": "number"
}
},
"type": "object"
},
"label": {
"type": "string"
},
"portfolio": {
"description": "composite, environmental, social, governance, tier, avgFeeSurcharge, totalFeeImpactBps",
"type": "object"
},
"topPerformers": {
"type": "array"
},
"worstOffenders": {
"description": "Bottom 10% entities with weakest pillar identified",
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"address": {
"description": "Wallet address (0x...) to score. Omit for protocol default.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "esg.score",
"outputSchema": {
"properties": {
"address": {
"description": "Scored wallet address or \"default\"",
"type": "string"
},
"environmental": {
"description": "Environmental score 0–100",
"type": "number"
},
"esgScore": {
"description": "Composite ESG score 0–100",
"type": "number"
},
"feePct": {
"description": "ESG fee percentage applied at settlement",
"type": "number"
},
"governance": {
"description": "Governance score 0–100",
"type": "number"
},
"social": {
"description": "Social score 0–100",
"type": "number"
},
"sources": {
"description": "Data sources used",
"items": {
"type": "string"
},
"type": "array"
},
"tier": {
"description": "ESG tier label",
"type": "string"
},
"updatedAt": {
"description": "ISO 8601 last update timestamp",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Supply Chain ESG Screen — screens an entire supplier/counterparty supply chain for ESG risk exposure. Accepts a focal entity (by LEI or wallet address) and traces upstream supply chain relationships via GLEIF. Returns per-tier ESG scores, highest-risk nodes, SFDR PAI exposure from supply chain, and a Scope 3 financed-emissions estimate. Useful for procurement teams, ESG-adjusted settlement pricing, and CSRD supply chain due diligence. x402 paid, USDC on Base.",
"inputSchema": {
"properties": {
"depth": {
"description": "Supply chain depth to trace (1 = direct suppliers, 2 = tier-2). Default 1. Max 2.",
"type": "number"
},
"entity": {
"description": "LEI or wallet address of the focal company.",
"type": "string"
}
},
"required": [
"entity"
],
"type": "object"
},
"name": "esg.supply_chain",
"outputSchema": {
"properties": {
"scope3Estimate": {
"description": "PCAF Scope 3 Category 1 estimate — attributed emissions.",
"type": "object"
},
"supplyChainScore": {
"description": "Aggregate supply chain ESG composite 0–100.",
"type": "number"
},
"synthesis": {
"description": "Plain-language supply chain ESG narrative.",
"type": "string"
},
"tiers": {
"description": "Per-tier: nodes, avgEsgScore, highRiskNodes, sfdrPaiFlags.",
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"days": {
"description": "Lookback window in days (7–365). Default 90.",
"type": "number"
},
"lei": {
"description": "20-character GLEIF LEI.",
"type": "string"
}
},
"required": [
"lei"
],
"type": "object"
},
"name": "esg.trend",
"outputSchema": {
"properties": {
"baseline": {
"type": "number"
},
"current": {
"type": "number"
},
"dataPoints": {
"type": "number"
},
"days": {
"type": "number"
},
"delta": {
"description": "Score change over the window (positive = improving)",
"type": "number"
},
"history": {
"type": "array"
},
"lei": {
"type": "string"
},
"trend": {
"enum": [
"IMPROVING",
"STABLE",
"DETERIORATING"
],
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"lei": {
"description": "20-character GLEIF LEI of the entity to monitor.",
"type": "string"
},
"thresholdPoints": {
"description": "Fire webhook if composite score changes by ≥ N points. Default 5. Minimum 1.",
"type": "number"
},
"webhookUrl": {
"description": "HTTPS URL to POST score change alerts to. Must be HTTPS.",
"type": "string"
}
},
"required": [
"lei",
"webhookUrl"
],
"type": "object"
},
"name": "esg.watch",
"outputSchema": {
"properties": {
"baselineScore": {
"description": "Composite score at registration (used as first comparison point)",
"type": "number"
},
"baselineTier": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"entityName": {
"type": "string"
},
"lei": {
"type": "string"
},
"watchId": {
"description": "UUID — use to check status (GET /esg/watch/:id) or cancel (DELETE /esg/watch/:id)",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"amountUsd": {
"description": "Settlement amount in USD",
"type": "number"
},
"esgScore": {
"description": "ESG score 0–100",
"type": "number"
},
"hasFx": {
"description": "Cross-currency? Adds 0.40% FX fee.",
"type": "boolean"
}
},
"required": [
"amountUsd"
],
"type": "object"
},
"name": "fees.compare",
"outputSchema": {
"properties": {
"amountUsd": {
"description": "Settlement amount compared",
"type": "number"
},
"comparison": {
"additionalProperties": {
"properties": {
"dpxCheaper": {
"type": "boolean"
},
"dpxSavings": {
"type": "number"
},
"feeUsd": {
"type": "number"
},
"name": {
"type": "string"
},
"rate": {
"type": "string"
}
},
"type": "object"
},
"description": "Per-competitor comparison keyed by competitor ID",
"type": "object"
},
"dpx": {
"properties": {
"feeUsd": {
"type": "number"
},
"rate": {
"type": "string"
}
},
"type": "object"
},
"note": {
"description": "Context note on comparison methodology",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "fees.schedule",
"outputSchema": {
"properties": {
"benchmarks": {
"additionalProperties": true,
"description": "Competitor fee benchmarks",
"type": "object"
},
"examples": {
"description": "Fee calculation examples",
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"fees": {
"description": "Fee component definitions",
"properties": {
"core": {
"properties": {
"description": {
"type": "string"
},
"pct": {
"type": "number"
}
},
"type": "object"
},
"esg": {
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"type": "object"
},
"fx": {
"properties": {
"description": {
"type": "string"
},
"pct": {
"type": "number"
}
},
"type": "object"
},
"license": {
"properties": {
"pct": {
"type": "number"
}
},
"type": "object"
}
},
"type": "object"
},
"tiers": {
"additionalProperties": true,
"description": "Volume discount tiers",
"type": "object"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"amountUsd": {
"description": "Settlement amount in USD",
"type": "number"
},
"esgScore": {
"description": "ESG score 0–100",
"type": "number"
},
"hasFx": {
"description": "Cross-currency settlement?",
"type": "boolean"
}
},
"required": [
"amountUsd"
],
"type": "object"
},
"name": "fees.verify",
"outputSchema": {
"properties": {
"delta": {
"description": "Absolute difference in basis points",
"type": "number"
},
"feesMatch": {
"description": "True if off-chain quote matches on-chain contract",
"type": "boolean"
},
"offChainFee": {
"properties": {
"pct": {
"type": "number"
},
"usd": {
"type": "number"
}
},
"type": "object"
},
"onChainFee": {
"properties": {
"pct": {
"type": "number"
},
"usd": {
"type": "number"
}
},
"type": "object"
},
"recommendation": {
"description": "PROCEED | INVESTIGATE",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"address": {
"description": "Counterparty wallet address for compliance screen (optional but recommended)",
"type": "string"
},
"amount": {
"description": "Settlement amount in source currency",
"type": "number"
},
"from": {
"description": "Source currency code (default: USD)",
"type": "string"
},
"lei": {
"description": "Counterparty LEI for enhanced compliance check (optional)",
"type": "string"
},
"to": {
"description": "Destination currency code (default: USD)",
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
},
"name": "flow_check",
"outputSchema": {
"properties": {
"compliance": {
"additionalProperties": true,
"type": "object"
},
"decision": {
"description": "PROCEED | HOLD | BLOCKED",
"type": "string"
},
"estimatedNetUsd": {
"description": "Estimated net received after all fees",
"type": "number"
},
"oracle": {
"additionalProperties": true,
"type": "object"
},
"ready": {
"description": "True when decision is PROCEED",
"type": "boolean"
},
"settleBody": {
"additionalProperties": true,
"description": "Ready to POST to /settle (null if BLOCKED or HOLD)",
"type": "object"
},
"token": {
"description": "Recommended stablecoin (USDC, EURC, or USDT)",
"type": "string"
},
"ttlSeconds": {
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "forecast.calendar",
"outputSchema": {
"properties": {
"calendar": {
"description": "Seasonal events sorted by urgency — active events first",
"type": "array"
},
"currentMonth": {
"description": "Current UTC month (1–12) for reference",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"fresh": {
"default": false,
"description": "true = bypass 4h cache and recompute live signals",
"type": "boolean"
},
"symbol": {
"description": "Commodity symbol",
"enum": [
"WHEAT",
"CORN",
"SOYB",
"COFFEE",
"COCOA",
"COTTON",
"SUGAR",
"WTI",
"NG",
"COPPER",
"LUMBER"
],
"type": "string"
}
},
"required": [
"symbol"
],
"type": "object"
},
"name": "forecast.commodity_outlook",
"outputSchema": {
"properties": {
"climateScore": {
"description": "Supply constraint pressure 0–100; >65 = elevated bullish pressure",
"type": "number"
},
"confidence": {
"description": "Signal confidence 0–1",
"type": "number"
},
"currentPrice": {
"description": "Latest FRED price reference (value, unit, date)",
"type": "object"
},
"forecastedAt": {
"type": "string"
},
"horizons": {
"description": "30d / 60d / 90d — each has signal, confidence, basis",
"type": "object"
},
"inGrowingSeason": {
"description": "true = stressors in peak transmission window — act faster",
"type": "boolean"
},
"name": {
"type": "string"
},
"reasoning": {
"description": "Plain-language synthesis of climate signals and price implications",
"type": "string"
},
"recommendation": {
"enum": [
"REDUCE",
"UNDERWEIGHT",
"HOLD",
"MONITOR",
"BUILD"
],
"type": "string"
},
"regions": {
"description": "Per production-region climate scores and drought/temperature readings",
"type": "array"
},
"signal": {
"enum": [
"STRONGLY_BEARISH",
"BEARISH",
"NEUTRAL",
"BULLISH",
"STRONGLY_BULLISH"
],
"type": "string"
},
"stressors": {
"description": "Active climate stressors with severity, region, price impact estimate, probability",
"type": "array"
},
"symbol": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Commodity Heat Check — all 11 commodity symbols simultaneously scored RED / YELLOW / GREEN. Fast single-call scan of the full commodity universe: WHEAT, CORN, SOYB, COFFEE, COCOA, COTTON, SUGAR, WTI, NG, COPPER, LUMBER. Returns per-symbol climate stress signal, risk driver, and urgency label. Ideal for daily monitoring, dashboard widgets, and as a triage step before calling forecast.commodity_outlook for detail on flagged symbols. Free.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "forecast.heat_check",
"outputSchema": {
"properties": {
"summary": {
"description": "Plain-language summary of which markets are most stressed.",
"type": "string"
},
"symbols": {
"description": "Per-symbol: symbol, signal (RED/YELLOW/GREEN), urgency, primaryDriver, score.",
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"positions": {
"description": "Portfolio positions with symbol and weight",
"items": {
"properties": {
"symbol": {
"enum": [
"WHEAT",
"CORN",
"SOYB",
"COFFEE",
"COCOA",
"COTTON",
"SUGAR",
"WTI",
"NG",
"COPPER",
"LUMBER"
],
"type": "string"
},
"weight": {
"description": "Portfolio weight — any positive number; normalized to sum to 1.0",
"type": "number"
}
},
"required": [
"symbol",
"weight"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"positions"
],
"type": "object"
},
"name": "forecast.portfolio_stress",
"outputSchema": {
"properties": {
"dominantRisk": {
"description": "Most climate-stressed position",
"type": "string"
},
"hedgeCandidates": {
"description": "Symbols with climateScore ≤ 35 — potential climate hedges",
"type": "array"
},
"portfolioClimateScore": {
"description": "Weighted aggregate climate stress 0–100",
"type": "number"
},
"positions": {
"description": "Per-position signal and climate score",
"type": "array"
},
"stressedPositions": {
"description": "Symbols with climateScore ≥ 65",
"type": "array"
},
"summary": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "forecast.production_regions",
"outputSchema": {
"properties": {
"regions": {
"description": "Regions sorted by climate risk score, with affected commodities and risk level",
"type": "array"
},
"updatedAt": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"scenario": {
"description": "Built-in scenario ID — or omit and provide stressorOverrides",
"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"
],
"type": "string"
},
"stressorOverrides": {
"description": "Custom multipliers if not using a named scenario (1.0 = no change)",
"properties": {
"droughtMultiplier": {
"type": "number"
},
"frostMultiplier": {
"type": "number"
},
"stormMultiplier": {
"type": "number"
},
"temperatureMultiplier": {
"type": "number"
},
"wildfireMultiplier": {
"type": "number"
}
},
"type": "object"
},
"symbols": {
"description": "Symbols to analyze — omit for all 11",
"items": {
"enum": [
"WHEAT",
"CORN",
"SOYB",
"COFFEE",
"COCOA",
"COTTON",
"SUGAR",
"WTI",
"NG",
"COPPER",
"LUMBER"
],
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"name": "forecast.scenario",
"outputSchema": {
"properties": {
"description": {
"type": "string"
},
"portfolioImpact": {
"description": "mostImpacted, leastImpacted, averageClimateScore",
"type": "object"
},
"results": {
"description": "Per-commodity signal, climateScore, recommendation, topStressor, reasoning",
"type": "array"
},
"scenario": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Commodity Alert Webhook — register a URL to receive push alerts when a commodity signal crosses a threshold. Supports alerts on signal changes (BULLISH → BEARISH), confidence drops below a floor, or climate stress score crossing a level. Returns a subscriptionId for management. Alerts fire within 30 minutes of a signal change. Useful for autonomous agents that need to react to commodity market shifts without polling. x402 paid (first month), USDC on Base.",
"inputSchema": {
"properties": {
"alertOn": {
"description": "Trigger type. signal_change = any BULLISH/BEARISH/NEUTRAL flip. confidence_drop = confidence falls below threshold. climate_stress = climateScore crosses level. Default: signal_change.",
"enum": [
"signal_change",
"confidence_drop",
"climate_stress"
],
"type": "string"
},
"symbols": {
"description": "Commodity symbols to monitor. E.g. [\"WHEAT\", \"WTI\"]. Use [\"*\"] for all 11.",
"items": {
"type": "string"
},
"type": "array"
},
"threshold": {
"description": "For confidence_drop: minimum confidence floor (0–1). For climate_stress: score level (0–100). Not used for signal_change.",
"type": "number"
},
"webhookUrl": {
"description": "HTTPS URL to receive POST alerts.",
"type": "string"
}
},
"required": [
"webhookUrl",
"symbols"
],
"type": "object"
},
"name": "forecast.subscribe",
"outputSchema": {
"properties": {
"alertOn": {
"type": "string"
},
"subscriptionId": {
"description": "Subscription ID for updates and cancellation.",
"type": "string"
},
"symbols": {
"type": "array"
},
"webhookUrl": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "TCFD Physical Risk Report — generates a Task Force on Climate-related Financial Disclosures (TCFD) physical risk assessment for a commodity portfolio. Maps climate signals from all 11 commodity markets to TCFD physical risk categories (acute and chronic), scores transition risk alignment, and produces a structured report suitable for investor disclosure. Pass portfolio as an array of {symbol, positionUsd}. x402 paid, USDC on Base.",
"inputSchema": {
"properties": {
"horizon": {
"description": "Forecast horizon for risk assessment. Default 90d.",
"enum": [
"30d",
"60d",
"90d"
],
"type": "string"
},
"portfolio": {
"description": "Array of {symbol: \"WHEAT\", positionUsd: 500000}. Symbols: WHEAT · CORN · SOYB · COFFEE · COCOA · COTTON · SUGAR · WTI · NG · COPPER · LUMBER.",
"items": {
"type": "object"
},
"type": "array"
}
},
"required": [
"portfolio"
],
"type": "object"
},
"name": "forecast.tcfd_report",
"outputSchema": {
"properties": {
"disclosure": {
"description": "Draft TCFD disclosure narrative for the portfolio.",
"type": "string"
},
"physicalRisk": {
"description": "Acute and chronic physical risk scores per commodity, mapped to TCFD categories.",
"type": "object"
},
"portfolioScore": {
"description": "Aggregate TCFD physical risk score 0–100.",
"type": "number"
},
"transitionRisk": {
"description": "Policy, technology, market, and reputation transition risk signals.",
"type": "object"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"from": {
"description": "Optional: filter to corridors starting from this currency (e.g. USD)",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "fx.corridors",
"outputSchema": {
"properties": {
"corridorCount": {
"type": "number"
},
"corridors": {
"description": "Corridors sorted best-first with score, tier, vol, regulatory flags",
"type": "array"
},
"summary": {
"description": "Count by tier: OPTIMAL / FAVORABLE / CAUTION / ELEVATED_RISK / ADVERSE",
"type": "object"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"amount": {
"description": "Amount to send",
"type": "number"
},
"amountCurrency": {
"description": "Currency of the amount (defaults to from)",
"type": "string"
},
"from": {
"description": "Source currency ISO 4217 (e.g. USD)",
"type": "string"
},
"lei": {
"description": "Optional counterparty LEI for ESG-adjusted fee tier",
"type": "string"
},
"to": {
"description": "Target currency ISO 4217 (e.g. BRL)",
"type": "string"
}
},
"required": [
"from",
"to",
"amount"
],
"type": "object"
},
"name": "fx.cost_certainty",
"outputSchema": {
"properties": {
"corridorIntelligence": {
"description": "Corridor stability score, regulatory flags, cascade level",
"type": "object"
},
"costCertainty": {
"description": "48h volatility, uncertainty in USD, received range in target currency",
"type": "object"
},
"executionRecommendation": {
"description": "SETTLE_NOW / DELAY_24H / DELAY_48H with best execution window UTC",
"type": "object"
},
"railFees": {
"description": "All-in fee breakdown in USD",
"type": "object"
},
"settlement": {
"description": "Sent and received amounts with live FX rate",
"type": "object"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"from": {
"description": "Source currency ISO 4217 code (e.g. USD)",
"type": "string"
},
"to": {
"description": "Target currency ISO 4217 code (e.g. BRL)",
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"name": "fx.rate",
"outputSchema": {
"properties": {
"ask": {
"type": "number"
},
"bid": {
"type": "number"
},
"corridorFlags": {
"description": "Regulatory flags for this corridor",
"type": "array"
},
"dailyVolatilityPct": {
"description": "Estimated daily FX volatility %",
"type": "number"
},
"mid": {
"description": "Mid-market rate (from → to)",
"type": "number"
},
"pair": {
"type": "string"
},
"spreadPct": {
"description": "Implied interbank spread %",
"type": "number"
},
"updatedAt": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Kyriba TMS Integration — DPX settlement bridge for Kyriba treasury management systems. Accepts a Kyriba-formatted payment instruction and executes it through the DPX settlement flow with oracle gating, compliance screening, and stablecoin routing. Returns a Kyriba-compatible confirmation response including settlement ID, execution status, and fee breakdown. The client's own Kyriba OAuth credentials are used — DPX never holds credentials. Useful for treasury teams running Kyriba who want DPX oracle intelligence and on-chain settlement without leaving their TMS workflow. Free (settlement x402 fee charged at execute step).",
"inputSchema": {
"properties": {
"oauthToken": {
"description": "Client's Kyriba OAuth bearer token. Never stored by DPX.",
"type": "string"
},
"paymentInstruction": {
"description": "Kyriba SPI payment instruction object — amount, currency, counterparty, valueDate.",
"type": "object"
},
"sandbox": {
"description": "If true, oracle and compliance run live but no on-chain execution. Default true.",
"type": "boolean"
}
},
"required": [
"paymentInstruction"
],
"type": "object"
},
"name": "integration.kyriba",
"outputSchema": {
"properties": {
"execution": {
"description": "On-chain execution params (sender-funded — client calls approve() + settle()).",
"type": "object"
},
"kyribaRef": {
"description": "Kyriba-format confirmation reference.",
"type": "string"
},
"settlementId": {
"description": "DPX settlement ID.",
"type": "string"
},
"status": {
"description": "AUTHORIZED / SANDBOX / HELD / REVIEW / FAILED",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"id": {
"description": "verificationId returned by integration.verify.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "integration.status",
"outputSchema": {
"properties": {
"explorer": {
"description": "Basescan URL for the verification transaction.",
"type": "string"
},
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"status": {
"description": "Current verification state.",
"enum": [
"pending",
"verified",
"expired"
],
"type": "string"
},
"txHash": {
"description": "Transaction hash of the $0.01 payment. Present when verified.",
"type": "string"
},
"verifiedAt": {
"description": "ISO timestamp of on-chain confirmation. Present when status is \"verified\".",
"type": "string"
},
"walletAddress": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "FinCEN Travel Rule Compliance — generates and transmits Travel Rule records for cross-border payments over $3,000. Creates a FATF R16-compliant record with originator and beneficiary identity data, transaction details, and a cryptographic attestation. Returns a Travel Rule ID for the audit trail. Accepts the same settlement parameters as settlement.execute — use after oracle and compliance gates pass. Can also receive inbound Travel Rule records from counterparty VASPs. Free (included in settlement flow; standalone record creation available).",
"inputSchema": {
"properties": {
"amountUsd": {
"description": "Transfer amount in USD.",
"type": "number"
},
"beneficiaryAddress": {
"description": "Beneficiary wallet address.",
"type": "string"
},
"beneficiaryLei": {
"description": "Beneficiary LEI. Optional.",
"type": "string"
},
"beneficiaryName": {
"description": "Legal name of beneficiary entity. Optional if LEI provided.",
"type": "string"
},
"originatorAddress": {
"description": "Originator wallet address.",
"type": "string"
},
"originatorLei": {
"description": "Originator LEI. Optional.",
"type": "string"
},
"originatorName": {
"description": "Legal name of originator entity. Optional if LEI provided.",
"type": "string"
},
"purpose": {
"description": "Payment purpose code.",
"type": "string"
}
},
"required": [
"originatorAddress",
"beneficiaryAddress",
"amountUsd"
],
"type": "object"
},
"name": "integration.travel_rule",
"outputSchema": {
"properties": {
"attestation": {
"description": "Signed compliance attestation.",
"type": "string"
},
"status": {
"description": "RECORDED / TRANSMITTED / PENDING_ACK",
"type": "string"
},
"travelRuleId": {
"description": "FATF R16 Travel Rule record ID.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"apiKey": {
"description": "Optional: the DPX API key being registered for this integration. Stored as a hash — never logged in plaintext.",
"type": "string"
},
"walletAddress": {
"description": "The client wallet address (0x...) that will send the $0.01 verification payment.",
"type": "string"
}
},
"required": [
"walletAddress"
],
"type": "object"
},
"name": "integration.verify",
"outputSchema": {
"properties": {
"expiresAt": {
"description": "ISO timestamp — verification window closes after 24 hours.",
"type": "string"
},
"payment": {
"properties": {
"amount": {
"description": "Amount in USDC (0.01).",
"type": "string"
},
"network": {
"description": "base-mainnet",
"type": "string"
},
"to": {
"description": "DPX treasury address to send USDC to.",
"type": "string"
}
},
"type": "object"
},
"polling": {
"properties": {
"intervalSeconds": {
"type": "number"
},
"timeoutAt": {
"type": "string"
},
"url": {
"type": "string"
}
},
"type": "object"
},
"status": {
"description": "Always \"pending\" on creation.",
"type": "string"
},
"verificationId": {
"description": "Session ID — use with integration.status to poll for payment confirmation.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "48-Hour Forward Macro Call — structured 48h forward view with the top 3 macro risks for the next 48 hours, per-corridor settlement guidance, and a recommended execution strategy for large cross-border payments. Distinct from composite (which covers a 30/60/90d horizon) — this is the short-horizon tactical call for agents with imminent settlement decisions. Returns: topRisks (ranked by probability × impact), corridorAdvice (SETTLE_NOW / DELAY / AVOID per major pair), executionWindow (best 4h window in next 48h), settlementAdvice (structured go/no-go), and AI synthesis. $0.50 USDC. GET, no input required.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "intelligence.48h_call",
"outputSchema": {
"properties": {
"corridorAdvice": {
"description": "Per major corridor: SETTLE_NOW / DELAY / AVOID + rationale.",
"type": "object"
},
"executionWindow": {
"description": "Best 4h window in next 48h: startUtc, endUtc, compositeScore, rationale.",
"type": "object"
},
"settlementAdvice": {
"description": "Go / No-go / Conditional with conditions.",
"type": "string"
},
"synthesis": {
"description": "Full AI narrative.",
"type": "string"
},
"topRisks": {
"description": "Top 3 risks for next 48h: event, probability, impact, corridorsAffected.",
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"elapsedHours": {
"description": "Hours elapsed since the primary event. Default 24.",
"type": "number"
},
"eventType": {
"description": "Description of the primary event.",
"type": "string"
},
"horizonHours": {
"description": "Forward horizon to model in hours. Default 4320 (6 months).",
"type": "number"
},
"magnitude": {
"description": "Primary shock magnitude 1–100.",
"type": "number"
},
"origin": {
"description": "Origin node ID from the primary cascade (e.g. \"geo.conflict\", \"climate.drought\").",
"type": "string"
}
},
"required": [
"origin",
"magnitude"
],
"type": "object"
},
"name": "intelligence.aftershock",
"outputSchema": {
"properties": {
"synthesis": {
"type": "string"
},
"wave1": {
"description": "Immediate (0–72h): rebound, amplified, structural nodes.",
"type": "object"
},
"wave2": {
"description": "Policy response phase (1–4 weeks).",
"type": "object"
},
"wave3": {
"description": "Structural lock-in (1–6 months).",
"type": "object"
}
},
"type": "object"
}
},
{
"description": "Butterfly Effect Cascade — POST variant of market.cascade. Models how a shock originating at a specific node propagates through a 25-node network. Distinct from market.cascade (which takes a free-text event and models broad macro impact) — butterfly requires a specific origin node from the node taxonomy and returns a directed, time-ordered cascade chain optimised for agent decision loops. Use when you have a precise origin event and need to trace which downstream nodes are hit in what order. Input: originNode (required), magnitude 1–10, elapsed hours. $0.75 USDC. POST.",
"inputSchema": {
"properties": {
"elapsedHours": {
"description": "Hours since event origin — positions the propagation wave front. Default 0.",
"type": "number"
},
"magnitude": {
"description": "Shock severity 1–10. Default 5.",
"type": "number"
},
"originNode": {
"description": "Originating system node. Climate: drought, flood, carbon_price, wildfire, sea_level, heatwave. Geopolitical: sanctions, conflict, tariffs, regime_change, election, port_blockade. Economic: rate_decision, inflation, sovereign_debt, banking_stress, currency_crisis, recession. Commodity: oil, gas, grain, rare_earth, copper, water, fertilizer.",
"type": "string"
}
},
"required": [
"originNode"
],
"type": "object"
},
"name": "intelligence.butterfly",
"outputSchema": {
"properties": {
"cascadeChain": {
"description": "Time-ordered nodes hit: node, lag_hours, attenuatedMagnitude, transmissionPath.",
"type": "array"
},
"nodeMap": {
"description": "Full 25-node state after propagation.",
"type": "object"
},
"synthesis": {
"description": "AI briefing on highest-impact transmission paths and concentrated risk.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Climate Intelligence Suite — three climate endpoints bundled. (1) climate: 50-year precipitation shift across 10 agricultural zones — food inflation and migration pressure signals. (2) climate-pulse: near-real-time temperature anomaly and drought stress across 8 US regions, updated every 3h — use for commodity trading desks and ag-sector settlement exposure. (3) earth-systems: Earth Health Index (0–100) and proximity to 9 climate tipping points — long-horizon investors and TNFD-aligned portfolio stress. All three returned in one response. GET, no input required. $0.50 USDC (bundled rate). Data: NOAA, USDA, FRED. Cache: climate 6h, pulse 3h, earth-systems 24h.",
"inputSchema": {
"properties": {
"signals": {
"description": "Subset of signals to return. Omit for all three.",
"items": {
"enum": [
"climate",
"climate-pulse",
"earth-systems"
],
"type": "string"
},
"type": "array"
}
},
"required": [],
"type": "object"
},
"name": "intelligence.climate",
"outputSchema": {
"properties": {
"climate": {
"description": "agriculturalZones, precipitationShift, foodInflationSignal, migrationPressure, synthesis.",
"type": "object"
},
"climatePulse": {
"description": "regions, temperatureAnomaly, droughtIndex, heatwaveRisk, cropStressSignal.",
"type": "object"
},
"earthSystems": {
"description": "earthHealthIndex, tippingPoints (9), proximityScores, catastropheRisk, synthesis.",
"type": "object"
}
},
"type": "object"
}
},
{
"description": "Composite Intelligence Report — synthesizes all active intelligence signals into a single structured macro brief. Calls all non-POST intelligence endpoints internally, weights their outputs by a live calibration model, and returns a ranked risk register, corridor-level settlement guidance, a 30/60/90-day outlook, and a full AI synthesis narrative. The highest-value single-call output in the intelligence API — use when a counterparty, treasury team, or agent needs a comprehensive cross-domain briefing rather than individual signals. Also available: synthesis (same output structured as a formatted executive report rather than machine-readable JSON). $1.00 USDC. GET, no input required.",
"inputSchema": {
"properties": {
"format": {
"description": "json = machine-readable risk register (default). report = executive summary narrative via intelligence.synthesis endpoint.",
"enum": [
"json",
"report"
],
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "intelligence.composite",
"outputSchema": {
"properties": {
"compositeScore": {
"description": "Single 0–100 global macro risk score.",
"type": "number"
},
"corridorGuidance": {
"description": "Per-corridor settlement recommendation based on composite signal.",
"type": "object"
},
"outlook": {
"description": "30d, 60d, 90d macro regime probability.",
"type": "object"
},
"riskRegister": {
"description": "Ranked active risks: domain, severity, confidence, signals, outlook.",
"type": "array"
},
"synthesis": {
"description": "Full AI synthesis narrative.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"listNodes": {
"description": "If true, returns all valid origin node IDs instead of running a simulation.",
"type": "boolean"
},
"magnitude": {
"description": "Initial shock magnitude 1–100.",
"type": "number"
},
"origin": {
"description": "Origin node ID. Call intelligence.contagion with listNodes:true to discover valid IDs.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "intelligence.contagion",
"outputSchema": {
"properties": {
"containment": {
"description": "Forecast of when/if containment is achieved.",
"type": "object"
},
"spreadMap": {
"description": "Per-epoch infection state across all nodes.",
"type": "array"
},
"superspreaders": {
"description": "Nodes with highest R contribution.",
"type": "array"
},
"synthesis": {
"type": "string"
},
"systemR": {
"description": "System-level R value. ≥1.0 means spreading.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "ESG Regulatory Reporting Suite — four SFDR/TNFD/EU Taxonomy endpoints bundled into one call. Returns everything needed for institutional ESG disclosure in a single response. (1) sfdr-dashboard: SFDR PAI indicators for a portfolio address — mandatory Principal Adverse Impact metrics under SFDR Article 7. (2) financed-emissions: PCAF-aligned financed emissions calculation — Scope 3 Category 15, required under CSRD and SFDR PAI 1. (3) taxonomy-alignment: EU Taxonomy alignment scoring — % of activities meeting Do No Significant Harm criteria across 6 environmental objectives. (4) tnfd-report: full TNFD LEAP report — nature-related risk and opportunity assessment across Locate, Evaluate, Assess, Prepare stages. $1.50 USDC (bundled, saves $1.00 vs individual calls). POST for portfolio address.",
"inputSchema": {
"properties": {
"address": {
"description": "Wallet address or LEI of the entity/portfolio to report on.",
"type": "string"
},
"signals": {
"description": "Subset of reports to generate. Omit for all four.",
"items": {
"enum": [
"sfdr",
"financed-emissions",
"taxonomy",
"tnfd"
],
"type": "string"
},
"type": "array"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "intelligence.esg_reporting",
"outputSchema": {
"properties": {
"financedEmissions": {
"description": "PCAF Scope 3 Cat 15 — attributed emissions, data quality score, CSRD flag.",
"type": "object"
},
"sfdr": {
"description": "SFDR PAI indicators table — 18 mandatory + 2 optional climate indicators.",
"type": "object"
},
"taxonomyAlignment": {
"description": "EU Taxonomy — aligned %, per-objective DNSH assessment, eligibility map.",
"type": "object"
},
"tnfdReport": {
"description": "TNFD LEAP — locate (dependencies/impacts), evaluate (materiality), assess (scenarios), prepare (metrics).",
"type": "object"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "intelligence.gender_risk",
"outputSchema": {
"properties": {
"countries": {
"description": "Per-country: gbvRiskScore, opportunityScore, LFPR gap, WBL index, GDP per capita, transmission mechanisms.",
"type": "array"
},
"regionalSummary": {
"type": "object"
},
"synthesis": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Macro Stress & Instability Intelligence — two endpoints bundled into one tool call. (1) Macro-stress: credit regime classification (EXPANSION / LATE_CYCLE / STRESS / CRISIS) derived from FRED yield curve, credit spreads, and money supply — provides a 2–6 week FX lead signal. (2) Instability: structural regime-level risk across US, China, Russia, and EU — not episodic events but foundational political-economic stability. Use this before large cross-border settlements or when macro conditions are a factor in a payment decision. GET, no input required. $0.25 USDC (bundled rate, covers both signals). Data: FRED. 1h cache.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "intelligence.macro_stress",
"outputSchema": {
"properties": {
"instability": {
"description": "Per-region (US/China/Russia/EU): stabilityScore, regimeRisk, keyRisks, synthesis.",
"type": "object"
},
"macroStress": {
"description": "regime, score 0–100, creditSpreads, yieldCurve, signals, fxLeadSignal, synthesis.",
"type": "object"
}
},
"type": "object"
}
},
{
"description": "Nature & Water Risk Intelligence — two TNFD-aligned endpoints bundled. (1) water-risk: physical water stress across 6 regions with sector-level exposure for agriculture, semiconductors, and beverages — TNFD LEAP aligned, relevant to ESG screening and climate-adjusted settlement. (2) biodiversity: TNFD-aligned nature risk across 8 regions — IUCN Red List signals, sector dependency/impact matrix, SFDR PAI 7 biodiversity flag. Together they cover the nature-related financial disclosure requirements under TNFD and SFDR. GET, no input required. $0.35 USDC (bundled rate). Data: USGS, FAO, IUCN, World Bank. 12h cache.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "intelligence.nature_risk",
"outputSchema": {
"properties": {
"biodiversity": {
"description": "regions (8), iucnSignals, sectorDependency, sectorImpact, sfdrPai7, synthesis.",
"type": "object"
},
"waterRisk": {
"description": "regions (6), stressScore, sectorExposure, tnfdAlignment, synthesis.",
"type": "object"
}
},
"type": "object"
}
},
{
"description": "Political & Climate Transition Risk — two forward-looking structural risk endpoints bundled. (1) political-risk: regime stability, policy risk, and sanctions exposure across major economies — structured assessment of political disruption to cross-border payment corridors. (2) transition-risk: climate policy transition risk across industries and geographies — carbon price exposure, stranded asset risk, policy velocity, regulatory tightening signals. Critical for SFDR Article 8/9 compliance and climate-adjusted settlement pricing. GET, no input required. $0.75 USDC (bundled rate). Data: ACLED, FRED, World Bank WGI. 6h cache.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "intelligence.political_risk",
"outputSchema": {
"properties": {
"politicalRisk": {
"description": "Per-region: regimeStability, policyRisk, sanctionsExposure, corridorImpact, synthesis.",
"type": "object"
},
"transitionRisk": {
"description": "carbonPriceExposure, strandedAssetRisk, policyVelocity, sectorImpacts, synthesis.",
"type": "object"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "intelligence.resonance",
"outputSchema": {
"properties": {
"amplificationFactor": {
"description": "Constructive interference gain across dominant cluster.",
"type": "number"
},
"dangerZoneMatch": {
"description": "Similarity to historical crisis resonance patterns.",
"type": "object"
},
"resonanceClusters": {
"description": "Groups of 3+ signals in mutual resonance.",
"type": "array"
},
"synthesis": {
"type": "string"
},
"systemResonanceScore": {
"description": "0–100. Higher = more dangerous in-phase alignment.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Sovereign Debt & Currency Stress Intelligence — two FX-adjacent macro endpoints bundled. (1) sovereign-debt: debt sustainability and default risk for US, EU, UK, and Japan — tracks debt/GDP trajectory, yield dynamics, and cross-border contagion risk relevant to corridor safety. (2) currency-stress: G10 + EM currency stress scores, dollar regime classification, capital flow direction, and per-corridor settlement impact — which currency pairs are under structural pressure beyond current FX rates. Complements market.fx (which covers spot execution risk) with underlying structural analysis. GET, no input required. $0.35 USDC (bundled rate). Data: FRED, IMF. 2h cache.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "intelligence.sovereign_debt",
"outputSchema": {
"properties": {
"currencyStress": {
"description": "dollarRegime, g10Scores, emScores, capitalFlowDirection, corridorImpact, synthesis.",
"type": "object"
},
"sovereignDebt": {
"description": "perCountry: debtGdpRatio, yieldDynamic, defaultRisk, contagionRisk. systemicScore, synthesis.",
"type": "object"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"direction": {
"description": "Fire when signal goes above or below threshold. Default: above.",
"enum": [
"above",
"below"
],
"type": "string"
},
"label": {
"description": "Optional label for your own tracking.",
"type": "string"
},
"signal": {
"description": "Signal to monitor. Default: stability.",
"enum": [
"stability",
"cascade",
"macro_stress",
"climate",
"fx",
"any"
],
"type": "string"
},
"threshold": {
"description": "Score value (0–100) that triggers the webhook.",
"type": "number"
},
"webhookUrl": {
"description": "HTTPS URL to POST alerts to.",
"type": "string"
}
},
"required": [
"webhookUrl",
"threshold"
],
"type": "object"
},
"name": "intelligence.subscribe",
"outputSchema": {
"properties": {
"currentScore": {
"description": "Signal score at registration time",
"type": "number"
},
"deleteUrl": {
"type": "string"
},
"direction": {
"type": "string"
},
"signal": {
"type": "string"
},
"statusUrl": {
"type": "string"
},
"subscriptionId": {
"type": "string"
},
"threshold": {
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Cancel an intelligence subscription by ID. Stops future webhook alerts for that subscription. The alert log is retained for audit purposes.",
"inputSchema": {
"properties": {
"subscriptionId": {
"description": "UUID returned by intelligence.subscribe.",
"type": "string"
}
},
"required": [
"subscriptionId"
],
"type": "object"
},
"name": "intelligence.subscription.delete",
"outputSchema": {
"properties": {
"deleted": {
"type": "boolean"
},
"subscriptionId": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"subscriptionId": {
"description": "UUID returned by intelligence.subscribe.",
"type": "string"
}
},
"required": [
"subscriptionId"
],
"type": "object"
},
"name": "intelligence.subscription.get",
"outputSchema": {
"properties": {
"direction": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"lastFiredAt": {
"type": "string"
},
"lastScore": {
"type": "number"
},
"signal": {
"type": "string"
},
"subscriptionId": {
"type": "string"
},
"threshold": {
"type": "number"
},
"totalAlertsFired": {
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Supply Chain & Energy Transition Intelligence — two structural economic endpoints bundled. (1) supply-chain: global supply chain pressure index with waterway chokepoint scoring across 6 shipping lanes (Suez, Panama, Strait of Hormuz, Malacca, Bosphorus, Cape of Good Hope) — critical for trade-finance and goods-backed payment corridors. (2) energy-transition: renewable generation share, fossil fuel demand curve, and grid carbon intensity for US, EU, and global — relevant for climate-risk-adjusted treasury allocation and SFDR PAI reporting. GET, no input required. $0.25 USDC (bundled rate). Data: FRED, EIA. 4h cache.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "intelligence.supply_chain",
"outputSchema": {
"properties": {
"energyTransition": {
"description": "renewableShare, fossilDemandCurve, gridCarbonIntensity (US/EU/global), transitionVelocity, synthesis.",
"type": "object"
},
"supplyChain": {
"description": "pressureIndex, regime, chokepoints (6), tradeFlowSignals, settlementImpact, synthesis.",
"type": "object"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "intelligence.tectonic",
"outputSchema": {
"properties": {
"faultLines": {
"description": "Per-node: domain, label, stress, accumulationRate, yearsToRupture, tippingThreshold.",
"type": "array"
},
"ruptureSequence": {
"description": "Ordered fault lines by proximity to rupture.",
"type": "array"
},
"synthesis": {
"description": "AI briefing on the most dangerous structural accumulations.",
"type": "string"
},
"systemStress": {
"description": "Composite tectonic stress 0–100.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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).",
"inputSchema": {
"properties": {
"amount": {
"description": "Invoice amount in source currency",
"type": "number"
},
"callbackUrl": {
"description": "URL to notify when invoice is paid",
"type": "string"
},
"currency": {
"description": "Source currency code (default: USD)",
"type": "string"
},
"description": {
"description": "Human-readable payment description",
"type": "string"
},
"destinationCurrency": {
"description": "Destination currency (default: same as currency)",
"type": "string"
},
"recipientAddress": {
"description": "Payee wallet address (can also be provided at pay time)",
"type": "string"
},
"ttlSeconds": {
"description": "Invoice TTL in seconds (default: 86400 = 24h)",
"type": "number"
}
},
"required": [
"amount"
],
"type": "object"
},
"name": "invoice.create",
"outputSchema": {
"properties": {
"expiresAt": {
"type": "string"
},
"invoiceId": {
"description": "UUID — pass to invoice.get or invoice.pay",
"type": "string"
},
"payUrl": {
"description": "Direct URL to pay this invoice",
"type": "string"
},
"status": {
"description": "OPEN | PAID | EXPIRED",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"invoiceId": {
"description": "Invoice UUID returned by invoice.create",
"type": "string"
}
},
"required": [
"invoiceId"
],
"type": "object"
},
"name": "invoice.get",
"outputSchema": {
"properties": {
"amount": {
"type": "number"
},
"currency": {
"type": "string"
},
"expiresAt": {
"type": "string"
},
"id": {
"type": "string"
},
"payUrl": {
"type": "string"
},
"status": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"invoiceId": {
"description": "Invoice UUID to pay",
"type": "string"
},
"recipientAddress": {
"description": "Payee wallet address (required if not set in invoice)",
"type": "string"
},
"sandbox": {
"description": "True for sandbox simulation. Default: true — set false only for live execution.",
"type": "boolean"
}
},
"required": [
"invoiceId"
],
"type": "object"
},
"name": "invoice.pay",
"outputSchema": {
"properties": {
"invoiceId": {
"type": "string"
},
"settlement": {
"additionalProperties": true,
"description": "Full settlement result from POST /settle",
"type": "object"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"session_id": {
"description": "Session or task ID — the same ID used in receipt.create calls",
"type": "string"
}
},
"required": [
"session_id"
],
"type": "object"
},
"name": "ledger.session",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"eventType": {
"description": "Free-text description of the specific event (e.g. \"Russia-Ukraine escalation\", \"Sahel drought season\", \"Fed emergency 75bps hike\").",
"type": "string"
},
"horizonHours": {
"description": "Forward time horizon in hours (1–720). Default: 168 (1 week). Use 24 for immediate cascade, 720 for full 30-day view.",
"type": "number"
},
"listNodes": {
"description": "If true, returns all valid origin node IDs and descriptions instead of running a cascade. Use this first to discover valid origin values.",
"type": "boolean"
},
"magnitude": {
"description": "Shock magnitude 1–100. 100 = maximum plausible shock for this event type. 40–60 = significant but not extreme.",
"type": "number"
},
"origin": {
"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\").",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "market.cascade",
"outputSchema": {
"properties": {
"cascade": {
"description": "Time-ordered propagation chain — each entry has node, magnitude, arrivalHours, via path, and mechanism.",
"type": "array"
},
"computedAt": {
"description": "ISO timestamp of computation.",
"type": "string"
},
"eventType": {
"description": "Event description provided.",
"type": "string"
},
"horizonHours": {
"description": "Time horizon modeled.",
"type": "number"
},
"inputMagnitude": {
"description": "Clamped input magnitude.",
"type": "number"
},
"origin": {
"description": "Origin node metadata.",
"type": "object"
},
"synthesis": {
"description": "AI intelligence briefing on transmission paths, concentrated risk, feedback loops, and forward signals.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "market.fx",
"outputSchema": {
"properties": {
"bestCorridors": {
"description": "Pairs with NORMAL or FAVORABLE risk — settle now.",
"type": "array"
},
"corridors": {
"description": "Per-pair risk, spot rate, advice, and settlement cost.",
"type": "array"
},
"dxy": {
"description": "DXY value, trend, regime, and settlement impact summary.",
"type": "object"
},
"executiveSummary": {
"description": "Plain-language summary of FX settlement conditions.",
"type": "string"
},
"overallRisk": {
"description": "FAVORABLE / NORMAL / MODERATE / HIGH / CRITICAL",
"type": "string"
},
"recommendedActions": {
"description": "Actionable guidance for treasury teams.",
"type": "array"
},
"worstCorridors": {
"description": "Pairs with HIGH or CRITICAL risk — delay or hedge.",
"type": "array"
}
},
"type": "object"
}
},
{
"description": "Shipping & Logistics Stress Intelligence — composite view of global freight market conditions across ocean, air, truck, and rail. Tracks energy-driven shipping costs (Brent crude, diesel), 8 key global trade routes with disruption status, and trade flow signals. Returns a settlementRelevance section mapping logistics conditions to cross-border payment corridor risk: invoice delay risk, trade finance stress, and affected corridors. Useful for treasury teams with supply chain financing exposure, trade finance desks, and agents pricing cross-border payments on goods-backed corridors. Data: FRED (Brent crude), EIA (US diesel). 4h cache.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "market.shipping",
"outputSchema": {
"properties": {
"compositeScore": {
"description": "Composite stress score 0–100 (higher = more stress).",
"type": "number"
},
"energyCost": {
"description": "Brent crude, diesel price, marine fuel proxy.",
"type": "object"
},
"freightModes": {
"description": "Per-mode (ocean/air/truck/rail) cost index and stress signal.",
"type": "array"
},
"keyRoutes": {
"description": "Per-route disruption status and stress score.",
"type": "array"
},
"regime": {
"description": "STABLE / MODERATE / ELEVATED / SEVERE_DISRUPTION",
"type": "string"
},
"settlementRelevance": {
"description": "Invoice delay risk, trade finance stress, affected corridors.",
"type": "object"
},
"synthesis": {
"description": "Narrative briefing on freight conditions and implications.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "mercury.accounts",
"outputSchema": {
"properties": {
"accounts": {
"items": {
"properties": {
"availableBalance": {
"description": "Available balance in USD",
"type": "number"
},
"currency": {
"description": "Currency code (USD)",
"type": "string"
},
"currentBalance": {
"description": "Current balance (in dollars)",
"type": "number"
},
"id": {
"description": "Mercury account ID — use with mercury.transactions and mercury.send",
"type": "string"
},
"kind": {
"description": "Account type: checking, savings, etc.",
"type": "string"
},
"name": {
"description": "Account name",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"count": {
"description": "Number of accounts returned",
"type": "number"
},
"environment": {
"description": "sandbox or production",
"type": "string"
},
"total": {
"description": "Total balance across all accounts in USD",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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.\n\nUse this tool BEFORE every ACH payment via mercury.send. ACH is hard to reverse — compliance pre-screening prevents blocked transactions and BSA/AML exposure.\n\nWorkflow:\n1. mercury.ach_authorize (screen only, autoExecute:false) → review decision\n2. If APPROVED → set autoExecute:true to send, or call mercury.send directly\n3. If FLAGGED → manual review required before proceeding\n4. If BLOCKED → do not proceed",
"inputSchema": {
"properties": {
"accountId": {
"description": "Source Mercury account ID (from mercury.accounts).",
"type": "string"
},
"amount": {
"description": "Payment amount in USD.",
"type": "number"
},
"autoExecute": {
"description": "If true and compliance returns APPROVED, immediately sends the ACH payment. Default false — screen first, execute separately.",
"type": "boolean"
},
"externalMemo": {
"description": "External memo / reference visible to recipient (optional).",
"type": "string"
},
"idempotencyKey": {
"description": "Idempotency key for safe retries. Auto-generated if omitted.",
"type": "string"
},
"note": {
"description": "Payment memo / note (optional).",
"type": "string"
},
"purpose": {
"description": "Payment purpose category (optional — required by Mercury for domesticWire, recommended for ACH). E.g. \"Vendor\", \"Contractor\", \"Expenses\".",
"type": "string"
},
"recipientId": {
"description": "Mercury saved recipient ID (from mercury.send / POST /mercury/recipients).",
"type": "string"
},
"recipientName": {
"description": "Legal name of the recipient entity or individual — used for compliance screening.",
"type": "string"
}
},
"required": [
"accountId",
"amount",
"recipientId",
"recipientName"
],
"type": "object"
},
"name": "mercury.ach_authorize",
"outputSchema": {
"properties": {
"_next": {
"description": "Guidance on next action.",
"type": "string"
},
"authorized": {
"description": "True if compliance approved the payment.",
"type": "boolean"
},
"compliance": {
"additionalProperties": true,
"description": "Full compliance oracle response including framework attestations.",
"type": "object"
},
"decision": {
"description": "Compliance decision.",
"enum": [
"APPROVED",
"FLAGGED",
"BLOCKED"
],
"type": "string"
},
"executed": {
"description": "True if autoExecute:true and ACH was sent.",
"type": "boolean"
},
"mercuryId": {
"description": "Mercury transaction ID (present when executed).",
"type": "string"
},
"reason": {
"description": "Human-readable decision summary.",
"type": "string"
},
"requiresReview": {
"description": "True when decision is FLAGGED — manual review required.",
"type": "boolean"
},
"tier": {
"description": "Compliance tier — FAST_PATH, STANDARD, ENHANCED, or HOLD.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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).\n\nFor 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.\n\nCan 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.\n\nUse sandbox:true (default) for dry-run testing. Set sandbox:false only when ready to move real funds.\n\nTypical cross-border flow:\n 1. market.fx → check FX corridor risk for the destination currency\n 2. mercury.accounts → get source accountId\n 3. mercury.send (sandbox:true) → confirm payment parameters\n 4. settlement.quote → get DPX fee quote for the USDC leg\n 5. mercury.send (sandbox:false) → execute (requires explicit user confirmation)\n 6. mercury.transactions → verify payment posted",
"inputSchema": {
"properties": {
"accountId": {
"description": "Source Mercury account ID (from mercury.accounts).",
"type": "string"
},
"accountNumber": {
"description": "Recipient account number (required for ach/wire/check). Also used for IBAN on internationalWire.",
"type": "string"
},
"amount": {
"description": "Payment amount in USD (or destination currency if specified).",
"type": "number"
},
"bankAddress": {
"description": "Beneficiary bank street address.",
"type": "string"
},
"bankCity": {
"description": "Beneficiary bank city.",
"type": "string"
},
"bankCountry": {
"description": "Beneficiary bank country — ISO 3166-1 alpha-2 (e.g. \"GB\", \"DE\", \"SG\").",
"type": "string"
},
"bankName": {
"description": "Beneficiary bank name (e.g. \"Barclays Bank UK PLC\").",
"type": "string"
},
"currency": {
"description": "Destination currency for internationalWire (e.g. \"GBP\", \"EUR\"). Default USD.",
"type": "string"
},
"dpxRoute": {
"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.",
"type": "boolean"
},
"note": {
"description": "Payment memo / description.",
"type": "string"
},
"paymentMethod": {
"description": "Payment rail. rtp = Real-Time Payment (instant, US domestic). internationalWire = cross-border (1–3 days). Default: ach.",
"enum": [
"ach",
"wire",
"rtp",
"internationalWire",
"check"
],
"type": "string"
},
"recipientAddress": {
"description": "Beneficiary street address.",
"type": "string"
},
"recipientCity": {
"description": "Beneficiary city.",
"type": "string"
},
"recipientCountry": {
"description": "Beneficiary country — ISO 3166-1 alpha-2.",
"type": "string"
},
"recipientEmail": {
"description": "Recipient email (optional — for payment notification).",
"type": "string"
},
"recipientId": {
"description": "Mercury saved recipient ID for internationalWire. Use this if the recipient is already saved in Mercury — skips inline bank detail fields.",
"type": "string"
},
"recipientName": {
"description": "Recipient legal name (required for ach/wire/rtp/check).",
"type": "string"
},
"recipientPostalCode": {
"description": "Beneficiary postal code.",
"type": "string"
},
"routingNumber": {
"description": "Recipient routing number (required for ach/wire/check).",
"type": "string"
},
"sandbox": {
"description": "Dry run — returns what would be sent without executing. Default: true. Set false to execute.",
"type": "boolean"
},
"swiftCode": {
"description": "BIC/SWIFT code of beneficiary bank (required for internationalWire without recipientId). E.g. \"BARCGB22\" for Barclays UK.",
"type": "string"
}
},
"required": [
"accountId",
"amount"
],
"type": "object"
},
"name": "mercury.send",
"outputSchema": {
"properties": {
"amount": {
"description": "Amount in USD",
"type": "number"
},
"dpxTagged": {
"description": "Whether the DPX routing tag was appended",
"type": "boolean"
},
"id": {
"description": "Mercury transaction ID (present when sandbox:false and executed)",
"type": "string"
},
"note": {
"description": "Payment memo as sent",
"type": "string"
},
"sandbox": {
"description": "True if this was a dry run",
"type": "boolean"
},
"simulation": {
"additionalProperties": true,
"description": "Dry-run summary (present when sandbox:true)",
"type": "object"
},
"status": {
"description": "Transaction status from Mercury",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.\n\nTHIS 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.\n\nSafety rules enforced:\n • Always keeps thresholdUsd in Mercury — never swept\n • Maximum 90% of sweepable amount deployed to sUSDS\n • Minimum 2-hour window required (shorter windows don't cover gas)\n • Minimum $50,000 sweepable (below this, gas costs exceed yield)\n • Exit triggered 30 minutes before settlement deadline\n\nCurrent instrument: sUSDS (Sky Protocol) — instant on-chain entry/exit, ~6.25% APY, Base chain, no US person restrictions, no de-peg events on record.\n\nWorkflow:\n1. mercury.accounts → get accountId and available balance\n2. mercury.sweep → get yield recommendation and execution steps\n3. If PROCEED → follow execution.steps to wire funds and deploy\n4. mercury.accounts again at exit time → confirm balance restored",
"inputSchema": {
"properties": {
"accountId": {
"description": "Mercury account ID to analyze (from mercury.accounts).",
"type": "string"
},
"riskTolerance": {
"description": "Risk tolerance for yield deployment. Conservative requires APY > 5%. Default: moderate.",
"enum": [
"conservative",
"moderate",
"aggressive"
],
"type": "string"
},
"sandbox": {
"description": "If true, marks analysis as sandbox mode — Mercury balance may not reflect live state.",
"type": "boolean"
},
"settlementDeadlineUtc": {
"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.",
"type": "string"
},
"thresholdUsd": {
"description": "Minimum USD balance to always keep in Mercury as a reserve. Sweepable = available balance minus this amount. Default: $50,000.",
"type": "number"
}
},
"required": [
"accountId"
],
"type": "object"
},
"name": "mercury.sweep",
"outputSchema": {
"properties": {
"account": {
"additionalProperties": true,
"description": "Mercury account summary with available balance, reserve threshold, and sweepable amount.",
"type": "object"
},
"execution": {
"additionalProperties": true,
"description": "Step-by-step execution instructions (present when recommendation is PROCEED).",
"type": "object"
},
"risk_disclosure": {
"description": "Mandatory risk disclosure — client must acknowledge before acting.",
"type": "string"
},
"yieldAnalysis": {
"additionalProperties": true,
"description": "Yield routing analysis: instrument, APY, expected net yield, window, and recommendation (PROCEED | HOLD).",
"type": "object"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"accountId": {
"description": "Mercury account ID (from mercury.accounts).",
"type": "string"
},
"limit": {
"description": "Number of transactions to return (default 20, max 500).",
"type": "number"
},
"offset": {
"description": "Pagination offset (default 0).",
"type": "number"
}
},
"required": [
"accountId"
],
"type": "object"
},
"name": "mercury.transactions",
"outputSchema": {
"properties": {
"accountId": {
"type": "string"
},
"total": {
"description": "Total number of transactions on this account",
"type": "number"
},
"transactions": {
"items": {
"properties": {
"amount": {
"description": "Amount in USD (negative = outgoing, positive = incoming)",
"type": "number"
},
"counterpartyName": {
"description": "Counterparty name",
"type": "string"
},
"createdAt": {
"description": "ISO 8601 creation timestamp",
"type": "string"
},
"dpxTagged": {
"description": "True if memo contains dpx: routing tag",
"type": "boolean"
},
"id": {
"description": "Mercury transaction ID",
"type": "string"
},
"note": {
"description": "Payment memo / note field",
"type": "string"
},
"status": {
"description": "pending | sent | failed | cancelled",
"type": "string"
}
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "Global Chaos Score — composite 0–100 instability index derived from all 11 Stability Oracle signal layers. Returns the raw numeric score, a regime label (CALM / ELEVATED / VOLATILE / HIGH / CRITICAL), a per-layer contribution breakdown, trend direction (IMPROVING / STABLE / DETERIORATING), and the key drivers pushing the score up or down. Distinct from oracle.stability (which gives a STABLE/CAUTION/UNSTABLE verdict) — this gives the underlying numeric signal useful for dashboards, monitoring, and threshold-triggered automation. Free.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "oracle.chaos_score",
"outputSchema": {
"properties": {
"keyDrivers": {
"description": "Top 3 factors currently driving the score.",
"type": "array"
},
"layers": {
"description": "Per-layer contribution: signal, score, weight, direction.",
"type": "array"
},
"regime": {
"description": "CALM / ELEVATED / VOLATILE / HIGH / CRITICAL",
"type": "string"
},
"score": {
"description": "Chaos index 0–100 (higher = more chaotic).",
"type": "number"
},
"trend": {
"description": "IMPROVING / STABLE / DETERIORATING",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"country": {
"description": "ISO-2 country code for World Bank WGI lookup (e.g. \"DE\", \"US\"). Optional but improves score accuracy.",
"type": "string"
},
"lei": {
"description": "20-character GLEIF LEI. Provide this for fastest response.",
"type": "string"
},
"q": {
"description": "Company name to resolve via GLEIF if LEI is unknown (e.g. \"Siemens AG\").",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "oracle.governance",
"outputSchema": {
"properties": {
"components": {
"description": "Per-source breakdown: gleif (LEI status, renewal) and worldbank (WGI indicators)",
"type": "object"
},
"composite": {
"description": "Governance score 0–100",
"type": "number"
},
"country": {
"type": "string"
},
"entityName": {
"type": "string"
},
"lei": {
"type": "string"
},
"mikaCompliant": {
"description": "True if composite ≥ 60 (MiCA Article 72 threshold)",
"type": "boolean"
},
"scoredAt": {
"type": "string"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
},
"tier": {
"enum": [
"STRONG",
"ADEQUATE",
"MODERATE",
"WEAK",
"POOR"
],
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "oracle.mycelium",
"outputSchema": {
"properties": {
"fruitingBodyRisk": {
"additionalProperties": true,
"type": "object"
},
"networkHealth": {
"description": "Composite network vitality score 0–100.",
"type": "number"
},
"networkNarrative": {
"type": "string"
},
"nodes": {
"additionalProperties": true,
"type": "object"
},
"regime": {
"description": "Network regime classification.",
"type": "string"
},
"threadHealth": {
"additionalProperties": true,
"type": "object"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"rails": {
"description": "Specific rails to check: 'PIX', 'SEPA', 'FedACH', 'CHAPS', 'UPI', 'PromptPay'. Omit for all.",
"items": {
"type": "string"
},
"type": "array"
},
"region": {
"description": "Filter by region: 'latam', 'europe', 'us', 'asia', 'uk'.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "oracle.rails",
"outputSchema": {
"properties": {
"healthScore": {
"description": "Composite rail health score 0–100",
"type": "number"
},
"rails": {
"additionalProperties": true,
"description": "Per-rail status map",
"type": "object"
},
"recommendation": {
"description": "Settlement recommendation based on rail health",
"type": "string"
},
"timestamp": {
"description": "ISO 8601 timestamp",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Settlement Gate — composite pre-flight check that bundles three clearance signals into one verdict. Calls: (1) Stability Oracle — macro/peg/FX gate; (2) Compliance Oracle — AML/sanctions tier for the counterparty; (3) SFDR pre-assessment — ESG PAI flags if applicable. Returns a single PROCEED / CAUTION / HOLD decision with per-gate sub-results and a plain-language rationale. Use this as a one-call replacement for running oracle.stability + flow_check + compliance.sfdr_screen separately before a large settlement. Pass counterparty wallet and settlement amount. Free.",
"inputSchema": {
"properties": {
"amountUsd": {
"description": "Settlement amount in USD.",
"type": "number"
},
"counterparty": {
"description": "Payee wallet address.",
"type": "string"
},
"currency": {
"description": "Source currency (default: USD).",
"type": "string"
}
},
"required": [
"counterparty",
"amountUsd"
],
"type": "object"
},
"name": "oracle.settlement_gate",
"outputSchema": {
"properties": {
"gates": {
"description": "oracle: {status, score}, compliance: {tier, flags}, sfdr: {paiFlags}.",
"type": "object"
},
"rationale": {
"description": "Plain-language reason for verdict.",
"type": "string"
},
"verdict": {
"description": "PROCEED / CAUTION / HOLD",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "oracle.stability",
"outputSchema": {
"properties": {
"outlook": {
"description": "Short-term stability outlook",
"type": "string"
},
"pegDeviation": {
"description": "USDC peg deviation in basis points",
"type": "number"
},
"reasoning": {
"description": "AI reasoning for current status",
"type": "string"
},
"recommendation": {
"description": "PROCEED | CAUTION | HOLD",
"type": "string"
},
"stabilityScore": {
"description": "Oracle stability score 0–100",
"type": "number"
},
"status": {
"description": "Current stability status",
"enum": [
"STABLE",
"CAUTION",
"UNSTABLE"
],
"type": "string"
},
"timestamp": {
"description": "ISO 8601 assessment timestamp",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Get full output from the latest DPX Stability Oracle run. Includes all 11 signal layers: climate & environmental, commodities & energy, macroeconomic, currency & FX, basket verification, infrastructure weak spots, war & conflict, bond yields & yield curve, geopolitical risk, capital flows, and USD structural health. Includes AI intelligence briefing.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "oracle.status",
"outputSchema": {
"properties": {
"alerts": {
"description": "Active oracle alerts",
"items": {
"type": "string"
},
"type": "array"
},
"briefing": {
"description": "AI intelligence briefing text",
"type": "string"
},
"chaosRegime": {
"description": "True if extreme market conditions detected",
"type": "boolean"
},
"score": {
"description": "Composite oracle score 0–100",
"type": "number"
},
"signals": {
"description": "Individual signal scores for all 11 oracle layers",
"properties": {
"basket": {
"type": "number"
},
"climate": {
"type": "number"
},
"commodities": {
"type": "number"
},
"fx": {
"type": "number"
},
"geopolitical": {
"type": "number"
},
"infrastructure": {
"type": "number"
},
"macro": {
"type": "number"
},
"usdHealth": {
"type": "number"
},
"yieldCurve": {
"type": "number"
}
},
"type": "object"
},
"status": {
"description": "STABLE | CAUTION | UNSTABLE",
"type": "string"
},
"tier": {
"description": "Oracle tier classification",
"type": "string"
},
"timestamp": {
"description": "ISO 8601 oracle run timestamp",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"agent_id": {
"description": "Agent identifier — must match the agent_id used in policy.create",
"type": "string"
},
"amount_usd": {
"description": "Proposed payment amount in USD",
"type": "number"
},
"counterparty": {
"description": "Counterparty name or LEI",
"type": "string"
},
"delegation_id": {
"description": "If acting under a delegation from a parent agent, provide the delegation ID.",
"type": "string"
},
"oracle_status": {
"description": "Current oracle status — STABLE, CAUTION, or UNSTABLE. Get from get_reliability.",
"type": "string"
},
"purpose": {
"description": "Payment purpose string",
"type": "string"
},
"recipient": {
"description": "Recipient wallet address",
"type": "string"
},
"session_id": {
"description": "Task or session grouping ID for ledger tracking.",
"type": "string"
},
"to_currency": {
"description": "Destination currency code (e.g. EUR, GBP)",
"type": "string"
}
},
"required": [
"agent_id",
"amount_usd"
],
"type": "object"
},
"name": "policy.check",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"agent_id": {
"description": "Stable identifier for the agent or org (wallet address, session prefix, org slug, etc.)",
"type": "string"
},
"allowed_purposes": {
"description": "If set, only payments with a purpose in this list are allowed.",
"items": {
"type": "string"
},
"type": "array"
},
"blocked_counterparties": {
"description": "Wallet addresses or LEIs to block.",
"items": {
"type": "string"
},
"type": "array"
},
"blocked_regions": {
"description": "ISO 3166-1 alpha-2 country codes to block.",
"items": {
"type": "string"
},
"type": "array"
},
"max_per_day": {
"description": "USD rolling daily ceiling. Payments that would exceed this are HOLDed.",
"type": "number"
},
"max_per_tx": {
"description": "USD ceiling per single transaction. Payments above this are BLOCKED.",
"type": "number"
},
"name": {
"description": "Human-readable policy name",
"type": "string"
},
"require_hold_above": {
"description": "Route to HOLD queue for human review if amount exceeds this threshold.",
"type": "number"
},
"require_oracle_stable": {
"description": "If true, HOLD on CAUTION as well as UNSTABLE oracle status.",
"type": "boolean"
}
},
"required": [
"agent_id",
"name"
],
"type": "object"
},
"name": "policy.create",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"child_agent_id": {
"description": "The sub-agent receiving delegated authority",
"type": "string"
},
"expires_at": {
"description": "Unix timestamp (ms) when this delegation expires. Omit for no expiry.",
"type": "number"
},
"max_per_tx": {
"description": "Maximum USD per transaction for the sub-agent",
"type": "number"
},
"max_total": {
"description": "Lifetime spending ceiling for this delegation",
"type": "number"
},
"parent_agent_id": {
"description": "The authorising (parent) agent ID",
"type": "string"
},
"policy_id": {
"description": "Policy ID to inherit (optional — inherits parent policy if omitted)",
"type": "string"
}
},
"required": [
"parent_agent_id",
"child_agent_id"
],
"type": "object"
},
"name": "policy.delegate",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"section": {
"description": "Which section to return. Default 'all' returns the complete memo.",
"enum": [
"all",
"overview",
"product",
"traction",
"market",
"financials",
"compliance",
"raise",
"founder",
"risks"
],
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "protocol.investment_context",
"outputSchema": {
"properties": {
"_meta": {
"additionalProperties": true,
"description": "Memo metadata",
"type": "object"
},
"compliance": {
"additionalProperties": true,
"description": "Compliance posture",
"type": "object"
},
"financials": {
"additionalProperties": true,
"description": "Financial model",
"type": "object"
},
"founder": {
"additionalProperties": true,
"description": "Founder background",
"type": "object"
},
"market": {
"additionalProperties": true,
"description": "Market context",
"type": "object"
},
"overview": {
"additionalProperties": true,
"description": "Company overview",
"type": "object"
},
"product": {
"additionalProperties": true,
"description": "Product and technology",
"type": "object"
},
"raise": {
"additionalProperties": true,
"description": "Raise details",
"type": "object"
},
"risks": {
"additionalProperties": true,
"description": "Key risks",
"type": "object"
},
"traction": {
"additionalProperties": true,
"description": "Traction and metrics",
"type": "object"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "protocol.manifest",
"outputSchema": {
"properties": {
"agent": {
"additionalProperties": true,
"description": "Settlement Agent manifest: name, version, status",
"type": "object"
},
"oracle": {
"additionalProperties": true,
"description": "Oracle manifest: name, version, assets, endpoints",
"type": "object"
}
},
"type": "object"
}
},
{
"description": "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).",
"inputSchema": {
"properties": {
"amount": {
"description": "Card spending cap (e.g. \"10000.00\").",
"type": "string"
},
"currency": {
"description": "Currency code (default USD).",
"type": "string"
},
"display_name": {
"description": "Card label visible in Ramp dashboard.",
"type": "string"
},
"merchant_scope": {
"description": "Intended merchant name (informational).",
"type": "string"
},
"reference": {
"description": "Your internal reference ID.",
"type": "string"
},
"tenant_id": {
"description": "Tenant ID of the connected Ramp account.",
"type": "string"
}
},
"required": [
"tenant_id",
"amount"
],
"type": "object"
},
"name": "ramp.agent_card",
"outputSchema": {
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string"
},
"reference": {
"type": "string"
},
"statusUrl": {
"type": "string"
},
"taskId": {
"description": "Poll GET /ramp/agent-card/:taskId for card PAN/CVV.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"amount": {
"description": "Payment amount in units of currency.",
"type": "number"
},
"counterpartyCountry": {
"description": "ISO 3166-1 alpha-2 destination country (e.g. \"DE\", \"NG\", \"IR\").",
"type": "string"
},
"counterpartyLei": {
"description": "Optional GLEIF LEI — enables UBO chain check and satisfies FATF R.16 originator identification.",
"type": "string"
},
"counterpartyName": {
"description": "Legal name of the payment counterparty.",
"type": "string"
},
"currency": {
"description": "ISO 4217 currency code. Defaults to \"USD\".",
"type": "string"
},
"isIndividual": {
"description": "true if counterparty is an individual (triggers PEP screen). Defaults to false.",
"type": "boolean"
},
"paymentType": {
"description": "Payment type — payroll automatically triggers PEP screen.",
"enum": [
"vendor_payment",
"payroll",
"intercompany",
"other"
],
"type": "string"
},
"sourceCountry": {
"description": "ISO 3166-1 alpha-2 source country. Defaults to \"US\".",
"type": "string"
}
},
"required": [
"counterpartyName",
"amount"
],
"type": "object"
},
"name": "ramp.compliance_screen",
"outputSchema": {
"properties": {
"_action": {
"description": "Recommended action for the agent.",
"type": "string"
},
"checks": {
"description": "fatfCountry, amountFlags, sanctions, pep, uboChain check details.",
"type": "object"
},
"decision": {
"description": "Compliance decision.",
"enum": [
"APPROVED",
"FLAGGED",
"BLOCKED"
],
"type": "string"
},
"fatfR16": {
"description": "FATF R.16 satisfied status and basis.",
"type": "object"
},
"humanRequired": {
"description": "true only for FLAGGED — APPROVED payments proceed automatically.",
"type": "boolean"
},
"reasons": {
"description": "Specific reasons for the decision.",
"items": {
"type": "string"
},
"type": "array"
},
"riskScore": {
"description": "Risk score 0–100.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"tenant_id": {
"description": "Your internal tenant or customer ID — returned in the callback so you can match the connection.",
"type": "string"
}
},
"required": [
"tenant_id"
],
"type": "object"
},
"name": "ramp.connect",
"outputSchema": {
"properties": {
"authorize_url": {
"description": "Redirect the user to this URL to authorize DPX on their Ramp account.",
"type": "string"
},
"scopes": {
"description": "Requested OAuth scopes.",
"type": "string"
},
"tenant_id": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"amount": {
"description": "Payment amount (e.g. \"50000.00\").",
"type": "string"
},
"callback_url": {
"description": "Webhook URL for pacs.002 delivery.",
"type": "string"
},
"creditor_lei": {
"description": "Recipient LEI for GLEIF VoP (optional).",
"type": "string"
},
"creditor_name": {
"description": "Recipient name.",
"type": "string"
},
"creditor_wallet": {
"description": "Recipient on-chain wallet address (0x...).",
"type": "string"
},
"currency": {
"description": "Source currency: USD or EUR.",
"type": "string"
},
"merchant_scope": {
"description": "Merchant name for Agent Card scope.",
"type": "string"
},
"reference": {
"description": "Your internal payment reference.",
"type": "string"
},
"settlement_asset": {
"description": "Settlement asset: USDC (default) or EURC.",
"type": "string"
},
"tenant_id": {
"description": "Tenant ID of the connected Ramp account.",
"type": "string"
}
},
"required": [
"tenant_id",
"amount",
"currency",
"creditor_wallet",
"creditor_name"
],
"type": "object"
},
"name": "ramp.settle",
"outputSchema": {
"properties": {
"agentCard": {
"type": "object"
},
"compliance": {
"description": "FATF R16 + SFDR PAI indicators.",
"type": "object"
},
"dpxPaymentId": {
"type": "string"
},
"iso20022": {
"description": "pacs.002 status object.",
"type": "object"
},
"settlement": {
"type": "object"
},
"status": {
"enum": [
"SETTLED",
"PENDING",
"BLOCKED",
"FAILED"
],
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"page_size": {
"description": "Number of bills to analyse (default 100, max 500).",
"type": "number"
},
"tenant_id": {
"description": "Tenant ID of the connected Ramp account.",
"type": "string"
}
},
"required": [
"tenant_id"
],
"type": "object"
},
"name": "ramp.spend_analysis",
"outputSchema": {
"properties": {
"crossBorder": {
"description": "Wire and international bill totals.",
"type": "object"
},
"dpxOpportunity": {
"description": "Estimated annual savings and DPX fees.",
"type": "object"
},
"topVendorsBySpend": {
"description": "Top 10 vendors by total payment volume.",
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"agent_id": {
"description": "Agent that executed the payment",
"type": "string"
},
"amount_usd": {
"description": "Amount paid in USD",
"type": "number"
},
"compliance_decision": {
"description": "Compliance decision at time of payment (PROCEED / HOLD / BLOCKED)",
"type": "string"
},
"counterparty": {
"description": "Counterparty name",
"type": "string"
},
"delegation_id": {
"description": "Delegation ID if acting under delegated authority",
"type": "string"
},
"from_currency": {
"description": "Source currency (default: USD)",
"type": "string"
},
"oracle_status": {
"description": "Oracle status at time of payment (STABLE / CAUTION / UNSTABLE)",
"type": "string"
},
"policy_id": {
"description": "Policy ID that governed this payment",
"type": "string"
},
"recipient": {
"description": "Recipient wallet address",
"type": "string"
},
"sandbox": {
"description": "True if this was a sandbox settlement",
"type": "boolean"
},
"session_id": {
"description": "Task or session ID for grouping (use the same ID for all payments in one agent run)",
"type": "string"
},
"settlement_id": {
"description": "Settlement ID returned by the settle tool",
"type": "string"
},
"task_context": {
"description": "Plain-text description of what task triggered this payment",
"type": "string"
},
"to_currency": {
"description": "Destination currency (default: USD)",
"type": "string"
},
"tx_hash": {
"description": "On-chain transaction hash (if live)",
"type": "string"
}
},
"required": [
"agent_id",
"amount_usd"
],
"type": "object"
},
"name": "receipt.create",
"outputSchema": null
},
{
"description": "AI-synthesized climate risk report — TCFD physical risk assessment, commodity stress signals across 11 markets, climate outlook (STABLE/ELEVATED/CRITICAL), and narrative risk guidance. Sourced from DPX Commodity Forecast Oracle and live climate signals. Cached hourly. Requires a pre-purchased DPX Reports API key via Authorization: Bearer <key>.",
"inputSchema": {
"properties": {
"apiKey": {
"description": "DPX Reports API key. Alternatively, set Authorization: Bearer <key> in the calling context.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "reports.climate",
"outputSchema": null
},
{
"description": "AI-synthesized compliance report — OpenSanctions global sanctions screening, PEP status, FATF country risk tier, AML risk score with signal breakdown, Travel Rule / FATF R.16 attestation status, and compliance verdict narrative. Requires lei or name. Requires a pre-purchased DPX Reports API key.",
"inputSchema": {
"properties": {
"apiKey": {
"description": "DPX Reports API key.",
"type": "string"
},
"lei": {
"description": "GLEIF LEI of the entity to screen.",
"type": "string"
},
"name": {
"description": "Entity name to screen (if no LEI). One of lei or name required.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "reports.compliance",
"outputSchema": null
},
{
"description": "AI-synthesized ESG report — all 18 SFDR Annex I PAI indicators, E/S/G sub-scores, CSRD financed emissions estimate, fee tier implication for DPX settlement, and ESG disclosure narrative. Requires a wallet address or LEI. Requires a pre-purchased DPX Reports API key.",
"inputSchema": {
"properties": {
"address": {
"description": "Wallet address or on-chain entity address to score.",
"type": "string"
},
"apiKey": {
"description": "DPX Reports API key.",
"type": "string"
},
"lei": {
"description": "Optional GLEIF LEI for SFDR PAI report.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "reports.esg",
"outputSchema": null
},
{
"description": "AI-synthesized macro report — global macro stability score (0–100), regime classification (STABLE/CAUTION/UNSTABLE), USD structural health across 12 signals, 30/60/90-day outlook with confidence scores, and synthesis across geopolitical, FX, credit, and supply chain signals. Sourced from DPX Stability Oracle v9. Cached hourly. Requires a pre-purchased DPX Reports API key.",
"inputSchema": {
"properties": {
"apiKey": {
"description": "DPX Reports API key.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "reports.macro",
"outputSchema": null
},
{
"description": "AI-synthesized treasury report — 30-day settlement volume by corridor, AI decision audit (authorized/held/review/failed breakdown), average oracle score at settlement, escalation rate, and portfolio-level settlement health narrative. Requires a pre-purchased DPX Reports API key.",
"inputSchema": {
"properties": {
"apiKey": {
"description": "DPX Reports API key.",
"type": "string"
},
"period": {
"description": "ISO month (YYYY-MM). Defaults to current month.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "reports.treasury",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"amount": {
"description": "Settlement amount in source currency",
"type": "number"
},
"from": {
"description": "Source currency code (USD, EUR, GBP, BRL, etc.)",
"type": "string"
},
"to": {
"description": "Destination currency code (USD, EUR, GBP, etc.)",
"type": "string"
}
},
"required": [
"amount",
"from",
"to"
],
"type": "object"
},
"name": "route",
"outputSchema": {
"properties": {
"generatedAt": {
"type": "string"
},
"options": {
"items": {
"properties": {
"isCrossCurrency": {
"type": "boolean"
},
"rank": {
"type": "number"
},
"rationale": {
"type": "string"
},
"settleBody": {
"additionalProperties": true,
"type": "object"
},
"token": {
"type": "string"
},
"tokenAddress": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"routingAdvice": {
"properties": {
"oracleStabilityScore": {
"description": "Current oracle stability score 0–100",
"type": "number"
},
"rationale": {
"type": "string"
},
"recommendation": {
"description": "Top-ranked stablecoin (USDC, EURC, or USDT)",
"type": "string"
}
},
"type": "object"
},
"settleEndpoint": {
"type": "string"
},
"ttlSeconds": {
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"limit": {
"description": "Max results to return (default 3, max 5).",
"type": "number"
},
"query": {
"description": "Keywords to search — e.g. \"how to settle\", \"esg fee formula\", \"butterfly cascade\", \"mercury send\", \"compliance screen\".",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_docs",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"events": {
"description": "Event types (default: [\"settlement.completed\"])",
"items": {
"type": "string"
},
"type": "array"
},
"url": {
"description": "HTTPS endpoint to receive settlement.completed events",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "settle.subscribe",
"outputSchema": {
"properties": {
"events": {
"items": {
"type": "string"
},
"type": "array"
},
"subscriptionId": {
"type": "string"
},
"webhookSecret": {
"description": "HMAC secret — returned once, store immediately",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"amount": {
"description": "Amount in source currency units",
"type": "number"
},
"destinationCurrency": {
"description": "Destination currency: USD, EUR, GBP, USDC, EURC",
"type": "string"
},
"esgScore": {
"description": "ESG score override 0–100 (testing only)",
"type": "number"
},
"purpose": {
"description": "Payment purpose: intercompany, vendor-payment, payroll, treasury",
"type": "string"
},
"quoteId": {
"description": "Pre-fetched quoteId from get_quote (optional — agent fetches live if omitted)",
"type": "string"
},
"recipientAddress": {
"description": "On-chain recipient wallet address (0x...)",
"type": "string"
},
"referenceId": {
"description": "External reference ID (invoice number, TMS ID, etc.)",
"type": "string"
},
"sandbox": {
"description": "Sandbox mode — real calculations, no on-chain execution. Default: true.",
"type": "boolean"
},
"sourceCurrency": {
"description": "Source currency: USD, EUR, GBP, USDC, EURC",
"type": "string"
}
},
"required": [
"amount",
"sourceCurrency",
"destinationCurrency",
"recipientAddress"
],
"type": "object"
},
"name": "settlement.execute",
"outputSchema": {
"properties": {
"httpStatus": {
"description": "HTTP status from Settlement Agent",
"type": "number"
},
"result": {
"properties": {
"feesTotal": {
"description": "Total fees in USD",
"type": "number"
},
"netAmount": {
"description": "Net amount delivered after fees",
"type": "number"
},
"oracleScore": {
"description": "Oracle score at time of settlement",
"type": "number"
},
"oracleStatus": {
"description": "Oracle status at time of settlement",
"type": "string"
},
"reasoning": {
"description": "AI reasoning for settlement decision",
"type": "string"
},
"settlementId": {
"description": "Unique settlement ID (dpx_...)",
"type": "string"
},
"status": {
"enum": [
"executed",
"sandbox",
"held",
"failed"
],
"type": "string"
},
"timestamp": {
"description": "ISO 8601 settlement timestamp",
"type": "string"
},
"txHash": {
"description": "On-chain transaction hash (if executed)",
"type": "string"
}
},
"type": "object"
},
"summary": {
"description": "Human-readable settlement outcome summary",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "ISO 20022 Pain.001 Payment Intake — parses a pain.001 XML payment initiation message and converts it to a DPX /settle body. Handles single-credit and multi-credit transfer instructions. Returns a structured settle body ready to pass to settlement.execute, including oracle-validated corridor selection and stablecoin routing. Use this when receiving payment instructions from a TMS (Kyriba, FIS, SAP) or bank that emits ISO 20022 format. Free (parse only); the downstream settlement.execute call carries the x402 fee.",
"inputSchema": {
"properties": {
"pain001Xml": {
"description": "Raw pain.001 XML string.",
"type": "string"
},
"sandbox": {
"description": "Pass through to settlement.execute as sandbox mode. Default true.",
"type": "boolean"
},
"validateOnly": {
"description": "If true, parse and validate without returning a settle body. Default false.",
"type": "boolean"
}
},
"required": [
"pain001Xml"
],
"type": "object"
},
"name": "settlement.iso20022",
"outputSchema": {
"properties": {
"payments": {
"description": "Parsed payment instructions with amount, currency, creditor, debtor.",
"type": "array"
},
"settleBody": {
"description": "Structured body ready for settlement.execute. Null if validateOnly=true.",
"type": "object"
},
"validationErrors": {
"description": "Schema or business-rule validation errors, if any.",
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"instruction": {
"description": "Plain-English payment instruction, e.g. 'Pay Acme GmbH $25,000 USD for invoice #INV-2026-0042'",
"type": "string"
},
"recipientAddress": {
"description": "Recipient wallet address (0x...)",
"type": "string"
},
"sandbox": {
"description": "Set false for live execution. Default: true",
"type": "boolean"
}
},
"required": [
"instruction",
"recipientAddress"
],
"type": "object"
},
"name": "settlement.nl",
"outputSchema": {
"properties": {
"aiConfidence": {
"type": "number"
},
"aiDecision": {
"type": "string"
},
"feesTotal": {
"type": "number"
},
"netAmount": {
"type": "number"
},
"settlementId": {
"type": "string"
},
"status": {
"type": "string"
},
"txHash": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"amountUsd": {
"description": "Settlement amount in USD.",
"type": "number"
},
"counterpartyName": {
"description": "Counterparty company name — used for ESG auto-lookup if lei is not provided.",
"type": "string"
},
"esgScore": {
"description": "Counterparty ESG score 0–100. If omitted and lei or counterpartyName is provided, the ESG Oracle is queried automatically.",
"type": "number"
},
"hasFx": {
"description": "True if source and destination currencies differ (adds 0.40% FX fee).",
"type": "boolean"
},
"lei": {
"description": "Counterparty LEI — triggers automatic ESG lookup if esgScore is not provided.",
"type": "string"
},
"monthlyVolumeUsd": {
"description": "Monthly volume for discount tier. $1M+ = Institutional (20% off). $10M+ = Sovereign (30% off).",
"type": "number"
}
},
"required": [
"amountUsd"
],
"type": "object"
},
"name": "settlement.quote",
"outputSchema": {
"properties": {
"amountUsd": {
"description": "Input settlement amount in USD",
"type": "number"
},
"expiresAt": {
"description": "ISO 8601 expiry timestamp",
"type": "string"
},
"fees": {
"properties": {
"core": {
"properties": {
"pct": {
"type": "number"
},
"usd": {
"type": "number"
}
},
"type": "object"
},
"esg": {
"properties": {
"pct": {
"type": "number"
},
"usd": {
"type": "number"
}
},
"type": "object"
},
"fx": {
"properties": {
"pct": {
"type": "number"
},
"usd": {
"type": "number"
}
},
"type": "object"
},
"license": {
"properties": {
"pct": {
"type": "number"
},
"usd": {
"type": "number"
}
},
"type": "object"
},
"total": {
"properties": {
"pct": {
"type": "number"
},
"usd": {
"type": "number"
}
},
"type": "object"
}
},
"type": "object"
},
"netAmountUsd": {
"description": "Net amount after all fees",
"type": "number"
},
"oracleScore": {
"description": "Oracle confidence 0–100",
"type": "number"
},
"oracleStatus": {
"description": "STABLE | CAUTION | UNSTABLE",
"type": "string"
},
"quoteId": {
"description": "Binding quote ID, valid 300 seconds",
"type": "string"
},
"reasoning": {
"description": "AI reasoning for fee calculation",
"type": "string"
},
"tier": {
"description": "Volume tier: Standard | Growth | Institutional | Sovereign",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"settlementId": {
"description": "Settlement ID from the settlement.execute tool (format: dpx_...)",
"type": "string"
}
},
"required": [
"settlementId"
],
"type": "object"
},
"name": "settlement.status",
"outputSchema": {
"properties": {
"httpStatus": {
"description": "HTTP status from Settlement Agent",
"type": "number"
},
"settlement": {
"properties": {
"amount": {
"type": "number"
},
"destinationCurrency": {
"type": "string"
},
"esgScore": {
"type": "number"
},
"feesTotal": {
"type": "number"
},
"netAmount": {
"type": "number"
},
"oracleStatus": {
"type": "string"
},
"reasoning": {
"type": "string"
},
"settlementId": {
"type": "string"
},
"sourceCurrency": {
"type": "string"
},
"status": {
"enum": [
"executed",
"sandbox",
"held",
"failed",
"pending"
],
"type": "string"
},
"timestamp": {
"type": "string"
},
"txHash": {
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
}
},
{
"description": "Settlement Dry Run — returns the full oracle response a real /settle call would receive, without payment or on-chain execution. Runs live oracle gate, live compliance pre-check, and fee math. Use this to demonstrate the settlement flow to a human, onboard a new agent, or verify oracle conditions before committing a payment. No authentication required, no USDC needed. Returns: oracle status and score, compliance tier, fee estimate, stablecoin routing, and a plain-language settlement brief. Free.",
"inputSchema": {
"properties": {
"amountUsd": {
"description": "Settlement amount in USD.",
"type": "number"
},
"destinationCurrency": {
"description": "Destination currency (default: USD).",
"type": "string"
},
"sourceCurrency": {
"description": "Source currency (default: USD).",
"type": "string"
}
},
"required": [
"amountUsd"
],
"type": "object"
},
"name": "settlement.try",
"outputSchema": {
"properties": {
"brief": {
"description": "Plain-language settlement brief.",
"type": "string"
},
"compliance": {
"description": "tier, flags, amlStatus.",
"type": "object"
},
"feeEstimate": {
"description": "totalBps, grossUsd, netUsd, intelligenceFee.",
"type": "object"
},
"oracle": {
"description": "status, score, reasoning.",
"type": "object"
},
"stablecoin": {
"description": "Recommended stablecoin for this settlement.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "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?\"",
"inputSchema": {
"properties": {
"from": {
"description": "Source currency ISO-4217 code (e.g. \"USD\", \"EUR\", \"GBP\").",
"type": "string"
},
"to": {
"description": "Destination currency ISO-4217 code (e.g. \"BRL\", \"MXN\", \"SGD\").",
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"name": "stability.corridor",
"outputSchema": {
"properties": {
"components": {
"description": "globalOracleScore, corridorAdjustment, cascadePenalty, liquidityScore, weekendPenalty",
"type": "object"
},
"corridor": {
"description": "score (0–100), tier, recommendation (SETTLE_NOW/DELAY_24H/DELAY_48H), regulatoryFlags, corridorNotes",
"type": "object"
},
"marketContext": {
"description": "cascadeLevel, globalOutlook, currentUtcHour, isWeekend",
"type": "object"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"amount": {
"description": "Settlement amount (default 1,000,000). Used for large-amount guidance ≥$5M.",
"type": "number"
},
"currency": {
"description": "Currency of the amount (defaults to from).",
"type": "string"
},
"from": {
"description": "Source currency ISO-4217 (e.g. \"USD\").",
"type": "string"
},
"lei": {
"description": "Optional 20-char GLEIF LEI of counterparty — fetches live ESG tier to apply counterparty risk penalty.",
"type": "string"
},
"to": {
"description": "Destination currency ISO-4217 (e.g. \"BRL\").",
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"name": "stability.settlement_window",
"outputSchema": {
"properties": {
"marketContext": {
"description": "globalOracleScore, corridorAdjustment, cascadeLevel, globalOutlook, regulatoryFlags",
"type": "object"
},
"recommendation": {
"description": "bestWindow (ISO datetime), bestScore, optimalCount, goodCount, summary, largeAmountNote",
"type": "object"
},
"windows": {
"description": "18 × 4-hour slots: startUtc, endUtc, compositeScore, tier, components, recommendation, rationale",
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"properties": {
"amountUsd": {
"description": "Settlement amount in USD (used for liquidity tier and large-amount warnings).",
"type": "number"
},
"from": {
"description": "Source currency ISO-4217 (e.g. \"USD\").",
"type": "string"
},
"to": {
"description": "Destination currency ISO-4217 (e.g. \"EUR\", \"BRL\", \"AED\").",
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"name": "stability.stablecoin_route",
"outputSchema": {
"properties": {
"evaluatedAt": {
"description": "ISO timestamp",
"type": "string"
},
"recommendation": {
"description": "symbol, chain, reason, micaCompliant, geniusActCompliant",
"type": "object"
},
"routes": {
"description": "Ranked stablecoin options — each with symbol, liquidityTier, regulatoryFlags, warnings, blocked status, notes",
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.\n\nUse 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.\n\nDPX is not a SWIFT member — the SWIFT member bank submits the returned pacs.002 to the gpi Tracker via their own gpi API access.",
"inputSchema": {
"properties": {
"uetr": {
"description": "RFC 4122 UUID UETR assigned at payment initiation, e.g. \"97ed4827-7b6f-4491-a06f-b548d5a7512d\".",
"type": "string"
}
},
"required": [
"uetr"
],
"type": "object"
},
"name": "swift.gpi_track",
"outputSchema": {
"properties": {
"dpxPaymentId": {
"description": "DPX internal payment ID.",
"type": "string"
},
"gpiStatus": {
"description": "ACCP | PDNG | RJCT",
"type": "string"
},
"pacs002": {
"additionalProperties": true,
"description": "Full ISO 20022 pacs.002 payload for gpi Tracker submission.",
"type": "object"
},
"uetr": {
"description": "The UETR provided.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Treasury Float Yield Routing Analysis — OPTIONAL, CLIENT-DIRECTED ONLY.\n\nAnalyzes 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.\n\nTHIS 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.\n\nCurrent supported instrument: sUSDS (Sky Protocol Savings Rate). Selected because:\n • Instant on-chain entry and exit (no T+1 delays)\n • No US person restrictions\n • Real asset backing (tokenized RWAs + Spark borrow rates)\n • Available on Base chain via bridge\n • No de-peg events recorded (unlike synthetic alternatives)\n\nSafety parameters enforced:\n • Maximum 90% of settlement amount — 10% always stays in USDC\n • Early exit triggered 30 minutes before settlement deadline (not 15)\n • Slippage guard: if DEX USDC/USDS quote shows >0.1% slippage, recommendation = HOLD\n • Minimum viable window: 2 hours (shorter windows do not justify entry/exit gas costs)\n\nNot recommended if:\n • Settlement window is < 2 hours\n • Amount is < $50,000 (gas costs erode yield)\n • Client has not acknowledged the risk_disclosure object in this response\n • Settlement is time-critical with zero tolerance for delay",
"inputSchema": {
"properties": {
"amountUsdc": {
"description": "Settlement amount in USDC. Minimum $50,000 for yield routing to be viable after gas costs.",
"type": "number"
},
"dryRun": {
"description": "If true, returns analysis without any on-chain queries. Useful for planning. Default: false.",
"type": "boolean"
},
"riskTolerance": {
"description": "conservative = sUSDS only (T-bill / RWA backed, instant exit). moderate = sUSDS with higher slippage tolerance (up to 0.15%). Default: conservative.",
"enum": [
"conservative",
"moderate"
],
"type": "string"
},
"settlementDeadlineUtc": {
"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.",
"type": "string"
}
},
"required": [
"amountUsdc",
"settlementDeadlineUtc"
],
"type": "object"
},
"name": "treasury.yield_route",
"outputSchema": {
"description": "Yield routing analysis. Check recommendation field before acting.",
"properties": {
"amountReserved": {
"description": "Amount kept in USDC regardless (10% floor).",
"type": "number"
},
"amountRoutable": {
"description": "Amount to deploy (90% of input, USDC). 10% stays in USDC.",
"type": "number"
},
"currentApyPct": {
"description": "Current Sky Savings Rate APY (live, from Sky Protocol).",
"type": "number"
},
"estimatedSlippage": {
"description": "Estimated DEX slippage for USDC→USDS→USDC round trip (%).",
"type": "number"
},
"exitBy": {
"description": "Recommended exit timestamp (30 min before deadline).",
"type": "string"
},
"expectedYieldUsdc": {
"description": "Expected yield for this window at current APY.",
"type": "number"
},
"gasEstimateUsdc": {
"description": "Estimated Base L2 gas cost for entry + exit in USDC.",
"type": "number"
},
"instrument": {
"description": "Recommended instrument (currently always sUSDS).",
"type": "string"
},
"instrument_detail": {
"description": "Background on the recommended instrument.",
"properties": {
"audit_status": {
"type": "string"
},
"backing": {
"type": "string"
},
"chain": {
"type": "string"
},
"depeg_history": {
"type": "string"
},
"exit_mechanism": {
"type": "string"
},
"issuer": {
"type": "string"
},
"name": {
"type": "string"
},
"us_persons": {
"type": "string"
}
},
"type": "object"
},
"netYieldUsdc": {
"description": "Expected yield minus gas costs.",
"type": "number"
},
"notViable": {
"description": "True if net yield is negative (gas exceeds expected yield).",
"type": "boolean"
},
"recommendation": {
"description": "ROUTE (deploy float), HOLD (stay in USDC), or INSUFFICIENT_WINDOW.",
"enum": [
"ROUTE",
"HOLD",
"INSUFFICIENT_WINDOW"
],
"type": "string"
},
"risk_disclosure": {
"description": "MUST be surfaced to the client before any action is taken.",
"properties": {
"acknowledgement_required": {
"type": "boolean"
},
"bridge_risk": {
"type": "string"
},
"liability": {
"type": "string"
},
"liquidity_risk": {
"type": "string"
},
"peg_risk": {
"type": "string"
},
"regulatory_note": {
"type": "string"
},
"smart_contract_risk": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"type": "object"
},
"slippageGuardTripped": {
"description": "True if slippage > 0.1% — recommendation will be HOLD.",
"type": "boolean"
},
"windowHours": {
"description": "Available window in hours (deadline minus now minus 30-min buffer).",
"type": "number"
}
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:c5ad0866d9bce258e44b0d62537ee201851953d5dca4dd6ca645b8861cab1d0a | sha256sum