DPX MCP Server

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "agent": {
      "type": "object",
      "description": "Settlement Agent manifest: name, version, status",
      "additionalProperties": true
    },
    "oracle": {
      "type": "object",
      "description": "Oracle manifest: name, version, assets, endpoints",
      "additionalProperties": true
    }
  }
}

{
  "title": "Protocol Manifest",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "amountUsd"
  ],
  "properties": {
    "lei": {
      "type": "string",
      "description": "Counterparty LEI — triggers automatic ESG lookup if esgScore is not provided."
    },
    "hasFx": {
      "type": "boolean",
      "description": "True if source and destination currencies differ (adds 0.40% FX fee)."
    },
    "esgScore": {
      "type": "number",
      "description": "Estimate only (ignored when senderAddress is given). Counterparty ESG score 0–100. If omitted and lei or counterpartyName is provided, the ESG Oracle is queried automatically."
    },
    "amountUsd": {
      "type": "number",
      "description": "Settlement amount in USD."
    },
    "senderAddress": {
      "type": "string",
      "description": "Paying agent wallet address. The ESG fee is charged on the PAYER's on-chain score, so pass this for an exact quote; esgScore, lei and counterpartyName are then ignored."
    },
    "counterpartyName": {
      "type": "string",
      "description": "Counterparty company name — used for ESG auto-lookup if lei is not provided."
    },
    "monthlyVolumeUsd": {
      "type": "number",
      "description": "Ignored. Volume discounts are not applied by the router, so none are quoted."
    }
  }
}

{
  "type": "object",
  "properties": {
    "fees": {
      "type": "object",
      "properties": {
        "fx": {
          "type": "object",
          "properties": {
            "pct": {
              "type": "number"
            },
            "usd": {
              "type": "number"
            }
          }
        },
        "esg": {
          "type": "object",
          "properties": {
            "pct": {
              "type": "number"
            },
            "usd": {
              "type": "number"
            }
          }
        },
        "core": {
          "type": "object",
          "properties": {
            "pct": {
              "type": "number"
            },
            "usd": {
              "type": "number"
            }
          }
        },
        "total": {
          "type": "object",
          "properties": {
            "pct": {
              "type": "number"
            },
            "usd": {
              "type": "number"
            }
          }
        },
        "license": {
          "type": "object",
          "properties": {
            "pct": {
              "type": "number"
            },
            "usd": {
              "type": "number"
            }
          }
        }
      }
    },
    "tier": {
      "type": "string",
      "description": "Volume tier: Standard | Growth | Institutional | Sovereign"
    },
    "quoteId": {
      "type": "string",
      "description": "Binding quote ID, valid 300 seconds"
    },
    "amountUsd": {
      "type": "number",
      "description": "Input settlement amount in USD"
    },
    "expiresAt": {
      "type": "string",
      "description": "ISO 8601 expiry timestamp"
    },
    "reasoning": {
      "type": "string",
      "description": "AI reasoning for fee calculation"
    },
    "oracleScore": {
      "type": "number",
      "description": "Oracle confidence 0–100"
    },
    "netAmountUsd": {
      "type": "number",
      "description": "Net amount after all fees"
    },
    "oracleStatus": {
      "type": "string",
      "description": "STABLE | CAUTION | UNSTABLE"
    }
  }
}

{
  "title": "Settlement Quote",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "address": {
      "type": "string",
      "description": "Wallet address (0x...) to score. Omit for protocol default."
    }
  }
}

{
  "type": "object",
  "properties": {
    "tier": {
      "type": "string",
      "description": "ESG tier label"
    },
    "feePct": {
      "type": "number",
      "description": "ESG fee percentage applied at settlement"
    },
    "social": {
      "type": "number",
      "description": "Social score 0–100"
    },
    "address": {
      "type": "string",
      "description": "Scored wallet address or \"default\""
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Data sources used"
    },
    "esgScore": {
      "type": "number",
      "description": "Composite ESG score 0–100"
    },
    "updatedAt": {
      "type": "string",
      "description": "ISO 8601 last update timestamp"
    },
    "governance": {
      "type": "number",
      "description": "Governance score 0–100"
    },
    "environmental": {
      "type": "number",
      "description": "Environmental score 0–100"
    }
  }
}

{
  "title": "ESG Score",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Company name, domain, or ticker to look up (e.g. \"Apple Inc\", \"siemens.com\", \"MSFT\")"
    },
    "country": {
      "type": "string",
      "description": "ISO-2 country code to narrow results (e.g. \"US\", \"DE\"). Optional but improves match accuracy."
    },
    "narrate": {
      "type": "boolean",
      "description": "Set true to include a 2–3 sentence plain-English compliance narrative generated by the AI synthesis layer."
    }
  }
}

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "score": {
      "type": "object",
      "description": "Full ESG score object with composite, environmental, social, governance, feeTier, feeSurcharge, sources, coverage"
    },
    "resolved": {
      "type": "object",
      "properties": {
        "lei": {
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "leiStatus": {
          "type": "string"
        },
        "entityName": {
          "type": "string"
        }
      }
    },
    "narration": {
      "type": "string",
      "description": "Plain-language compliance narrative (only when narrate=true)"
    }
  }
}

{
  "title": "ESG Lookup",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "leis": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of LEIs to screen (fastest path — no GLEIF resolution needed)."
    },
    "names": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of company names to screen (resolved via GLEIF — slower, allows ≤3s per name)."
    }
  }
}

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number"
    },
    "failed": {
      "type": "number"
    },
    "results": {
      "type": "array",
      "description": "Entities sorted by composite score descending. Each item includes lei, entityName, score object, or an error note."
    },
    "succeeded": {
      "type": "number"
    }
  }
}

{
  "title": "ESG Batch Score",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "lei",
    "webhookUrl"
  ],
  "properties": {
    "lei": {
      "type": "string",
      "description": "20-character GLEIF LEI of the entity to monitor."
    },
    "webhookUrl": {
      "type": "string",
      "description": "HTTPS URL to POST score change alerts to. Must be HTTPS."
    },
    "thresholdPoints": {
      "type": "number",
      "description": "Fire webhook if composite score changes by ≥ N points. Default 5. Minimum 1."
    }
  }
}

{
  "type": "object",
  "properties": {
    "lei": {
      "type": "string"
    },
    "watchId": {
      "type": "string",
      "description": "UUID — use to check status (GET /esg/watch/:id) or cancel (DELETE /esg/watch/:id)"
    },
    "createdAt": {
      "type": "string"
    },
    "entityName": {
      "type": "string"
    },
    "baselineTier": {
      "type": "string"
    },
    "baselineScore": {
      "type": "number",
      "description": "Composite score at registration (used as first comparison point)"
    }
  }
}

{
  "title": "ESG Watch",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "leis": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "LEIs to score (fastest — no name resolution)."
    },
    "label": {
      "type": "string",
      "description": "Optional label for this portfolio (e.g. \"Q3 2026 Counterparties\")."
    },
    "names": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Company names to score (GLEIF-resolved)."
    }
  }
}

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string"
    },
    "entities": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number"
        },
        "failed": {
          "type": "number"
        },
        "scored": {
          "type": "number"
        }
      }
    },
    "portfolio": {
      "type": "object",
      "description": "composite, environmental, social, governance, tier, avgFeeSurcharge, totalFeeImpactBps"
    },
    "compliance": {
      "type": "object",
      "description": "micaArticle72, highRiskCount, sfdr flags"
    },
    "distribution": {
      "type": "object",
      "description": "byTier counts, min, max, median"
    },
    "topPerformers": {
      "type": "array"
    },
    "worstOffenders": {
      "type": "array",
      "description": "Bottom 10% entities with weakest pillar identified"
    }
  }
}

{
  "title": "ESG Portfolio Score",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "webhookUrl",
    "threshold"
  ],
  "properties": {
    "label": {
      "type": "string",
      "description": "Optional label for your own tracking."
    },
    "signal": {
      "enum": [
        "stability",
        "cascade",
        "macro_stress",
        "climate",
        "fx",
        "any"
      ],
      "type": "string",
      "description": "Signal to monitor. Default: stability."
    },
    "direction": {
      "enum": [
        "above",
        "below"
      ],
      "type": "string",
      "description": "Fire when signal goes above or below threshold. Default: above."
    },
    "threshold": {
      "type": "number",
      "description": "Score value (0–100) that triggers the webhook."
    },
    "webhookUrl": {
      "type": "string",
      "description": "HTTPS URL to POST alerts to."
    }
  }
}

{
  "type": "object",
  "properties": {
    "signal": {
      "type": "string"
    },
    "deleteUrl": {
      "type": "string"
    },
    "direction": {
      "type": "string"
    },
    "statusUrl": {
      "type": "string"
    },
    "threshold": {
      "type": "number"
    },
    "currentScore": {
      "type": "number",
      "description": "Signal score at registration time"
    },
    "subscriptionId": {
      "type": "string"
    }
  }
}

{
  "title": "Subscribe to Intelligence Alerts",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "subscriptionId"
  ],
  "properties": {
    "subscriptionId": {
      "type": "string",
      "description": "UUID returned by intelligence.subscribe."
    }
  }
}

{
  "type": "object",
  "properties": {
    "signal": {
      "type": "string"
    },
    "direction": {
      "type": "string"
    },
    "lastScore": {
      "type": "number"
    },
    "threshold": {
      "type": "number"
    },
    "lastFiredAt": {
      "type": "string"
    },
    "lastCheckedAt": {
      "type": "string"
    },
    "subscriptionId": {
      "type": "string"
    },
    "totalAlertsFired": {
      "type": "number"
    }
  }
}

{
  "title": "Get Intelligence Subscription",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "subscriptionId"
  ],
  "properties": {
    "subscriptionId": {
      "type": "string",
      "description": "UUID returned by intelligence.subscribe."
    }
  }
}

{
  "type": "object",
  "properties": {
    "deleted": {
      "type": "boolean"
    },
    "subscriptionId": {
      "type": "string"
    }
  }
}

{
  "title": "Delete Intelligence Subscription",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "lei"
  ],
  "properties": {
    "lei": {
      "type": "string",
      "description": "20-character GLEIF LEI."
    },
    "days": {
      "type": "number",
      "description": "Lookback window in days (7–365). Default 90."
    }
  }
}

{
  "type": "object",
  "properties": {
    "lei": {
      "type": "string"
    },
    "days": {
      "type": "number"
    },
    "delta": {
      "type": "number",
      "description": "Score change over the window (positive = improving)"
    },
    "trend": {
      "enum": [
        "IMPROVING",
        "STABLE",
        "DETERIORATING"
      ],
      "type": "string"
    },
    "current": {
      "type": "number"
    },
    "history": {
      "type": "array"
    },
    "baseline": {
      "type": "number"
    },
    "dataPoints": {
      "type": "number"
    }
  }
}

{
  "title": "ESG Trend",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "q": {
      "type": "string",
      "description": "Company name to resolve via GLEIF if LEI is unknown (e.g. \"Siemens AG\")."
    },
    "lei": {
      "type": "string",
      "description": "20-character GLEIF LEI. Provide this for fastest response."
    },
    "country": {
      "type": "string",
      "description": "ISO-2 country code for World Bank WGI lookup (e.g. \"DE\", \"US\"). Optional but improves score accuracy."
    }
  }
}

{
  "type": "object",
  "properties": {
    "lei": {
      "type": "string"
    },
    "tier": {
      "enum": [
        "STRONG",
        "ADEQUATE",
        "MODERATE",
        "WEAK",
        "POOR"
      ],
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "scoredAt": {
      "type": "string"
    },
    "composite": {
      "type": "number",
      "description": "Governance score 0–100"
    },
    "components": {
      "type": "object",
      "description": "Per-source breakdown: gleif (LEI status, renewal) and worldbank (WGI indicators)"
    },
    "entityName": {
      "type": "string"
    },
    "mikaCompliant": {
      "type": "boolean",
      "description": "True if composite ≥ 60 (MiCA Article 72 threshold)"
    }
  }
}

{
  "title": "Oracle Governance",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "lei"
  ],
  "properties": {
    "lei": {
      "type": "string",
      "description": "20-character GLEIF LEI of the entity to trace (e.g. \"2594007XIACKNMUAW223\")."
    },
    "deep": {
      "type": "boolean",
      "description": "Set true to attempt 3-level traversal including intermediate nodes. Default false (direct + ultimate parent only)."
    }
  }
}

{
  "type": "object",
  "properties": {
    "chain": {
      "type": "array",
      "description": "Per-node: level, role, lei, entityName, country, leiStatus, sanctions (matched, score, datasets), riskFlag"
    },
    "fatfR16": {
      "type": "object",
      "description": "FATF R.16 beneficial ownership compliance attestation"
    },
    "riskFlags": {
      "type": "array",
      "description": "Nodes with sanctions hits or lapsed LEIs"
    },
    "chainDepth": {
      "type": "number"
    },
    "overallStatus": {
      "enum": [
        "CLEAR",
        "REVIEW_REQUIRED",
        "BLOCKED"
      ],
      "type": "string"
    },
    "ultimateBeneficialOwner": {
      "type": "object",
      "description": "lei, entityName, country, leiStatus of the UBO"
    }
  }
}

{
  "title": "UBO Chain Lookup",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Full name to screen (e.g. \"Mario Draghi\")."
    },
    "country": {
      "type": "string",
      "description": "ISO-2 country code to narrow the search (e.g. \"IT\"). Optional."
    }
  }
}

{
  "type": "object",
  "properties": {
    "matched": {
      "type": "boolean"
    },
    "matches": {
      "type": "array",
      "description": "Per match: caption, datasets, position, nationality, birthDate, relatedEntities, riskLevel, matchScore"
    },
    "overallRisk": {
      "enum": [
        "HIGH",
        "MEDIUM",
        "LOW",
        "NONE"
      ],
      "type": "string"
    },
    "totalMatches": {
      "type": "number"
    },
    "fatfCompliance": {
      "type": "object",
      "description": "EDD required flag, FATF R.12/13 attestation, note"
    }
  }
}

{
  "title": "PEP Screening",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "inEffect": {
      "type": "array",
      "description": "Currently active requirements, most recent first"
    },
    "upcoming": {
      "type": "array",
      "description": "Events not yet in effect, sorted by effective date ascending"
    },
    "dpxAlignment": {
      "type": "object",
      "description": "Per-framework mapping to DPX endpoints that satisfy each obligation"
    }
  }
}

{
  "title": "Regulatory Calendar",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "q": {
      "type": "string",
      "description": "Optional keyword filter across term, definition, and category (e.g. \"collateral\", \"governance\")."
    }
  }
}

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number"
    },
    "label": {
      "type": "string"
    },
    "records": {
      "type": "array",
      "description": "Per term: id, term, definition, category, source"
    }
  }
}

{
  "title": "DeFi Concept Glossary",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "q": {
      "type": "string",
      "description": "Optional keyword filter across title, organization, summary, and category (e.g. \"mBridge\", \"reserve\")."
    }
  }
}

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number"
    },
    "label": {
      "type": "string"
    },
    "records": {
      "type": "array",
      "description": "Per paper: id, title, author, organization, date, category, summary, key_findings, source"
    }
  }
}

{
  "title": "CBDC/Stablecoin Research Library",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Destination currency ISO-4217 code (e.g. \"BRL\", \"MXN\", \"SGD\")."
    },
    "from": {
      "type": "string",
      "description": "Source currency ISO-4217 code (e.g. \"USD\", \"EUR\", \"GBP\")."
    }
  }
}

{
  "type": "object",
  "properties": {
    "corridor": {
      "type": "object",
      "description": "score (0–100), tier, recommendation (SETTLE_NOW/DELAY_24H/DELAY_48H), regulatoryFlags, corridorNotes"
    },
    "components": {
      "type": "object",
      "description": "globalOracleScore, corridorAdjustment, cascadePenalty, liquidityScore, weekendPenalty"
    },
    "marketContext": {
      "type": "object",
      "description": "cascadeLevel, globalOutlook, currentUtcHour, isWeekend"
    }
  }
}

{
  "title": "Stability Corridor",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Destination currency ISO-4217 (e.g. \"BRL\")."
    },
    "lei": {
      "type": "string",
      "description": "Optional 20-char GLEIF LEI of counterparty — fetches live ESG tier to apply counterparty risk penalty."
    },
    "from": {
      "type": "string",
      "description": "Source currency ISO-4217 (e.g. \"USD\")."
    },
    "amount": {
      "type": "number",
      "description": "Settlement amount (default 1,000,000). Used for large-amount guidance ≥$5M."
    },
    "currency": {
      "type": "string",
      "description": "Currency of the amount (defaults to from)."
    }
  }
}

{
  "type": "object",
  "properties": {
    "windows": {
      "type": "array",
      "description": "18 × 4-hour slots: startUtc, endUtc, compositeScore, tier, components, recommendation, rationale"
    },
    "marketContext": {
      "type": "object",
      "description": "globalOracleScore, corridorAdjustment, cascadeLevel, globalOutlook, regulatoryFlags"
    },
    "recommendation": {
      "type": "object",
      "description": "bestWindow (ISO datetime), bestScore, optimalCount, goodCount, summary, largeAmountNote"
    }
  }
}

{
  "title": "Settlement Window",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Destination currency ISO-4217 (e.g. \"EUR\", \"BRL\", \"AED\")."
    },
    "from": {
      "type": "string",
      "description": "Source currency ISO-4217 (e.g. \"USD\")."
    },
    "amountUsd": {
      "type": "number",
      "description": "Settlement amount in USD (used for liquidity tier and large-amount warnings)."
    }
  }
}

{
  "type": "object",
  "properties": {
    "routes": {
      "type": "array",
      "description": "Ranked stablecoin options — each with symbol, liquidityTier, regulatoryFlags, warnings, blocked status, notes"
    },
    "evaluatedAt": {
      "type": "string",
      "description": "ISO timestamp"
    },
    "recommendation": {
      "type": "object",
      "description": "symbol, chain, reason, micaCompliant, geniusActCompliant"
    }
  }
}

{
  "title": "Stablecoin Route",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Human-readable name for this agent."
    },
    "mandate": {
      "type": "object",
      "properties": {
        "esgFloor": {
          "type": "number",
          "description": "Minimum counterparty ESG score (0 = no floor)."
        },
        "expiresAt": {
          "type": "number",
          "description": "Unix timestamp for mandate expiry."
        },
        "dailyCapUsd": {
          "type": "number",
          "description": "Max USD per calendar day (UTC)."
        },
        "currencyPairs": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "e.g. [\"USD|EUR\"] (empty = any)."
        },
        "maxNotionalUsd": {
          "type": "number",
          "description": "Max USD per single settlement."
        },
        "counterpartyWhitelist": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "LEIs or wallet addresses (empty = any)."
        }
      },
      "description": "Optional AP2-compatible spend mandate (REGISTERED/VERIFIED only). Caps are clamped to tier limits for REGISTERED agents."
    },
    "ownerLei": {
      "type": "string",
      "description": "20-char GLEIF LEI. Providing a valid active LEI instantly grants VERIFIED tier — no documents. Get your LEI at gleif.org."
    },
    "framework": {
      "type": "string",
      "description": "Agent framework: \"claude\", \"gpt-4o\", \"gemini\", \"custom\", etc."
    },
    "protocols": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Supported protocols: [\"x402\", \"ap2\", \"mcp\", \"a2a\"]."
    },
    "publicKey": {
      "type": "string",
      "description": "Optional public key for credential signature verification."
    },
    "ownerEmail": {
      "type": "string",
      "description": "Contact email. Required for REGISTERED tier ($25K/day cap). Self-attested, not verified."
    },
    "ownerEntity": {
      "type": "string",
      "description": "Organization or person that owns/operates this agent. Required for REGISTERED tier."
    }
  }
}

{
  "type": "object",
  "properties": {
    "agentId": {
      "type": "string",
      "description": "Unique agent identifier (agt_...). Store this."
    },
    "kyaLevel": {
      "enum": [
        "ANONYMOUS",
        "REGISTERED",
        "VERIFIED"
      ],
      "type": "string"
    },
    "kyaScore": {
      "type": "number",
      "description": "Trust score 0–100."
    },
    "tierCaps": {
      "type": "object",
      "description": "maxNotionalUsd and dailyCapUsd effective for this agent."
    },
    "tierNote": {
      "type": "string",
      "description": "Explanation of tier and how to upgrade."
    },
    "leiVerified": {
      "type": "boolean",
      "description": "true if LEI was confirmed via GLEIF API."
    },
    "leiEntityName": {
      "type": "string",
      "description": "Legal name from GLEIF record (VERIFIED only)."
    }
  }
}

{
  "title": "Register Agent (KYA)",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "agentId",
    "maxNotionalUsd",
    "dailyCapUsd"
  ],
  "properties": {
    "agentId": {
      "type": "string",
      "description": "Agent ID from agent.kya_register."
    },
    "esgFloor": {
      "type": "number",
      "description": "Min counterparty ESG score (0 = no floor)."
    },
    "issuedBy": {
      "type": "string",
      "description": "Organization issuing this mandate."
    },
    "expiresAt": {
      "type": "number",
      "description": "Unix timestamp for mandate expiry."
    },
    "dailyCapUsd": {
      "type": "number",
      "description": "Max USD per calendar day (UTC)."
    },
    "currencyPairs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Allowed pairs e.g. [\"USD|EUR\"]. Empty = any pair."
    },
    "maxNotionalUsd": {
      "type": "number",
      "description": "Max USD per single settlement."
    },
    "counterpartyWhitelist": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "LEIs or wallet addresses. Empty = any counterparty."
    }
  }
}

{
  "type": "object",
  "properties": {
    "agentId": {
      "type": "string"
    },
    "mandate": {
      "type": "object",
      "description": "Full mandate object."
    },
    "mandateId": {
      "type": "string",
      "description": "Unique mandate ID (mnd_...)."
    },
    "ap2Compatible": {
      "type": "boolean"
    },
    "effectiveCaps": {
      "type": "object",
      "description": "Actual caps after tier clamping."
    }
  }
}

{
  "title": "Create Spend Mandate",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "agentId"
  ],
  "properties": {
    "agentId": {
      "type": "string",
      "description": "Agent ID from agent.kya_register (agt_...)."
    }
  }
}

{
  "type": "object",
  "properties": {
    "mandate": {
      "type": "object",
      "description": "Active mandate if present, null if expired."
    },
    "kyaLevel": {
      "type": "string"
    },
    "kyaScore": {
      "type": "number"
    },
    "verified": {
      "type": "boolean"
    },
    "credential": {
      "type": "object",
      "description": "agentId, issuedAt, expiresAt, mandateId, attestation (kyaLevel, ownerVerified, mandateActive, fatfCompliant, dailyCapUsd, maxNotionalUsd), signature"
    }
  }
}

{
  "title": "Verify Agent (KYA)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "symbol"
  ],
  "properties": {
    "fresh": {
      "type": "boolean",
      "default": false,
      "description": "true = bypass 4h cache and recompute live signals"
    },
    "symbol": {
      "enum": [
        "WHEAT",
        "CORN",
        "SOYB",
        "COFFEE",
        "COCOA",
        "COTTON",
        "SUGAR",
        "WTI",
        "NG",
        "COPPER",
        "LUMBER"
      ],
      "type": "string",
      "description": "Commodity symbol"
    }
  }
}

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "signal": {
      "enum": [
        "STRONGLY_BEARISH",
        "BEARISH",
        "NEUTRAL",
        "BULLISH",
        "STRONGLY_BULLISH"
      ],
      "type": "string"
    },
    "symbol": {
      "type": "string"
    },
    "regions": {
      "type": "array",
      "description": "Per production-region climate scores and drought/temperature readings"
    },
    "horizons": {
      "type": "object",
      "description": "30d / 60d / 90d — each has signal, confidence, basis"
    },
    "reasoning": {
      "type": "string",
      "description": "Plain-language synthesis of climate signals and price implications"
    },
    "stressors": {
      "type": "array",
      "description": "Active climate stressors with severity, region, price impact estimate, probability"
    },
    "confidence": {
      "type": "number",
      "description": "Signal confidence 0–1"
    },
    "climateScore": {
      "type": "number",
      "description": "Supply constraint pressure 0–100; >65 = elevated bullish pressure"
    },
    "currentPrice": {
      "type": "object",
      "description": "Latest FRED price reference (value, unit, date)"
    },
    "forecastedAt": {
      "type": "string"
    },
    "recommendation": {
      "enum": [
        "REDUCE",
        "UNDERWEIGHT",
        "HOLD",
        "MONITOR",
        "BUILD"
      ],
      "type": "string"
    },
    "inGrowingSeason": {
      "type": "boolean",
      "description": "true = stressors in peak transmission window — act faster"
    }
  }
}

{
  "title": "Commodity Outlook Forecast",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "positions"
  ],
  "properties": {
    "positions": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "symbol",
          "weight"
        ],
        "properties": {
          "symbol": {
            "enum": [
              "WHEAT",
              "CORN",
              "SOYB",
              "COFFEE",
              "COCOA",
              "COTTON",
              "SUGAR",
              "WTI",
              "NG",
              "COPPER",
              "LUMBER"
            ],
            "type": "string"
          },
          "weight": {
            "type": "number",
            "description": "Portfolio weight — any positive number; normalized to sum to 1.0"
          }
        }
      },
      "maxItems": 20,
      "description": "Portfolio positions with symbol and weight"
    }
  }
}

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string"
    },
    "positions": {
      "type": "array",
      "description": "Per-position signal and climate score"
    },
    "dominantRisk": {
      "type": "string",
      "description": "Most climate-stressed position"
    },
    "hedgeCandidates": {
      "type": "array",
      "description": "Symbols with climateScore ≤ 35 — potential climate hedges"
    },
    "stressedPositions": {
      "type": "array",
      "description": "Symbols with climateScore ≥ 65"
    },
    "portfolioClimateScore": {
      "type": "number",
      "description": "Weighted aggregate climate stress 0–100"
    }
  }
}

{
  "title": "Portfolio Stress Forecast",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "symbols": {
      "type": "array",
      "items": {
        "enum": [
          "WHEAT",
          "CORN",
          "SOYB",
          "COFFEE",
          "COCOA",
          "COTTON",
          "SUGAR",
          "WTI",
          "NG",
          "COPPER",
          "LUMBER"
        ],
        "type": "string"
      },
      "description": "Symbols to analyze — omit for all 11"
    },
    "scenario": {
      "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",
      "description": "Built-in scenario ID — or omit and provide stressorOverrides"
    },
    "stressorOverrides": {
      "type": "object",
      "properties": {
        "frostMultiplier": {
          "type": "number"
        },
        "stormMultiplier": {
          "type": "number"
        },
        "droughtMultiplier": {
          "type": "number"
        },
        "wildfireMultiplier": {
          "type": "number"
        },
        "temperatureMultiplier": {
          "type": "number"
        }
      },
      "description": "Custom multipliers if not using a named scenario (1.0 = no change)"
    }
  }
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "description": "Per-commodity signal, climateScore, recommendation, topStressor, reasoning"
    },
    "scenario": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "portfolioImpact": {
      "type": "object",
      "description": "mostImpacted, leastImpacted, averageClimateScore"
    }
  }
}

{
  "title": "Scenario Forecast",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "regions": {
      "type": "array",
      "description": "Regions sorted by climate risk score, with affected commodities and risk level"
    },
    "updatedAt": {
      "type": "string"
    }
  }
}

{
  "title": "Production Regions Forecast",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "calendar": {
      "type": "array",
      "description": "Seasonal events sorted by urgency — active events first"
    },
    "currentMonth": {
      "type": "number",
      "description": "Current UTC month (1–12) for reference"
    }
  }
}

{
  "title": "Forecast Calendar",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Target currency ISO 4217 code (e.g. BRL)"
    },
    "from": {
      "type": "string",
      "description": "Source currency ISO 4217 code (e.g. USD)"
    }
  }
}

{
  "type": "object",
  "properties": {
    "ask": {
      "type": "number"
    },
    "bid": {
      "type": "number"
    },
    "mid": {
      "type": "number",
      "description": "Mid-market rate (from → to)"
    },
    "pair": {
      "type": "string"
    },
    "spreadPct": {
      "type": "number",
      "description": "Implied interbank spread %"
    },
    "updatedAt": {
      "type": "string"
    },
    "corridorFlags": {
      "type": "array",
      "description": "Regulatory flags for this corridor"
    },
    "dailyVolatilityPct": {
      "type": "number",
      "description": "Estimated daily FX volatility %"
    }
  }
}

{
  "title": "FX Rate",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "from",
    "to",
    "amount"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Target currency ISO 4217 (e.g. BRL)"
    },
    "lei": {
      "type": "string",
      "description": "Optional counterparty LEI for ESG-adjusted fee tier"
    },
    "from": {
      "type": "string",
      "description": "Source currency ISO 4217 (e.g. USD)"
    },
    "amount": {
      "type": "number",
      "description": "Amount to send"
    },
    "amountCurrency": {
      "type": "string",
      "description": "Currency of the amount (defaults to from)"
    }
  }
}

{
  "type": "object",
  "properties": {
    "railFees": {
      "type": "object",
      "description": "All-in fee breakdown in USD"
    },
    "settlement": {
      "type": "object",
      "description": "Sent and received amounts with live FX rate"
    },
    "costCertainty": {
      "type": "object",
      "description": "48h volatility, uncertainty in USD, received range in target currency"
    },
    "corridorIntelligence": {
      "type": "object",
      "description": "Corridor stability score, regulatory flags, cascade level"
    },
    "executionRecommendation": {
      "type": "object",
      "description": "SETTLE_NOW / DELAY_24H / DELAY_48H with best execution window UTC"
    }
  }
}

{
  "title": "FX Cost Certainty",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "from": {
      "type": "string",
      "description": "Optional: filter to corridors starting from this currency (e.g. USD)"
    }
  }
}

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "object",
      "description": "Count by tier: OPTIMAL / FAVORABLE / CAUTION / ELEVATED_RISK / ADVERSE"
    },
    "corridors": {
      "type": "array",
      "description": "Corridors sorted best-first with score, tier, vol, regulatory flags"
    },
    "corridorCount": {
      "type": "number"
    }
  }
}

{
  "title": "FX Corridors",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "status": {
      "enum": [
        "STABLE",
        "CAUTION",
        "UNSTABLE"
      ],
      "type": "string",
      "description": "Current stability status"
    },
    "outlook": {
      "type": "string",
      "description": "Short-term stability outlook"
    },
    "reasoning": {
      "type": "string",
      "description": "AI reasoning for current status"
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 assessment timestamp"
    },
    "pegDeviation": {
      "type": "number",
      "description": "USDC peg deviation in basis points"
    },
    "recommendation": {
      "type": "string",
      "description": "PROCEED | CAUTION | HOLD"
    },
    "stabilityScore": {
      "type": "number",
      "description": "Oracle stability score 0–100"
    }
  }
}

{
  "title": "Stability Oracle",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "tier": {
      "type": "string",
      "description": "Oracle tier classification"
    },
    "score": {
      "type": "number",
      "description": "Composite oracle score 0–100"
    },
    "alerts": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Active oracle alerts"
    },
    "status": {
      "type": "string",
      "description": "STABLE | CAUTION | UNSTABLE"
    },
    "signals": {
      "type": "object",
      "properties": {
        "fx": {
          "type": "number"
        },
        "macro": {
          "type": "number"
        },
        "basket": {
          "type": "number"
        },
        "climate": {
          "type": "number"
        },
        "usdHealth": {
          "type": "number"
        },
        "yieldCurve": {
          "type": "number"
        },
        "commodities": {
          "type": "number"
        },
        "geopolitical": {
          "type": "number"
        },
        "infrastructure": {
          "type": "number"
        }
      },
      "description": "Individual signal scores for all 11 oracle layers"
    },
    "briefing": {
      "type": "string",
      "description": "AI intelligence briefing text"
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 oracle run timestamp"
    },
    "chaosRegime": {
      "type": "boolean",
      "description": "True if extreme market conditions detected"
    }
  }
}

{
  "title": "Oracle Status",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "fees": {
      "type": "object",
      "properties": {
        "fx": {
          "type": "object",
          "properties": {
            "pct": {
              "type": "number"
            },
            "description": {
              "type": "string"
            }
          }
        },
        "esg": {
          "type": "object",
          "properties": {
            "max": {
              "type": "number"
            },
            "min": {
              "type": "number"
            }
          }
        },
        "core": {
          "type": "object",
          "properties": {
            "pct": {
              "type": "number"
            },
            "description": {
              "type": "string"
            }
          }
        },
        "license": {
          "type": "object",
          "properties": {
            "pct": {
              "type": "number"
            }
          }
        }
      },
      "description": "Fee component definitions"
    },
    "tiers": {
      "type": "object",
      "description": "Volume discount tiers",
      "additionalProperties": true
    },
    "examples": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "description": "Fee calculation examples"
    },
    "benchmarks": {
      "type": "object",
      "description": "Competitor fee benchmarks",
      "additionalProperties": true
    }
  }
}

{
  "title": "Fee Schedule",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "amountUsd"
  ],
  "properties": {
    "hasFx": {
      "type": "boolean",
      "description": "Cross-currency settlement?"
    },
    "esgScore": {
      "type": "number",
      "description": "ESG score 0–100"
    },
    "amountUsd": {
      "type": "number",
      "description": "Settlement amount in USD"
    }
  }
}

{
  "type": "object",
  "properties": {
    "delta": {
      "type": "number",
      "description": "Absolute difference in basis points"
    },
    "feesMatch": {
      "type": "boolean",
      "description": "True if off-chain quote matches on-chain contract"
    },
    "onChainFee": {
      "type": "object",
      "properties": {
        "pct": {
          "type": "number"
        },
        "usd": {
          "type": "number"
        }
      }
    },
    "offChainFee": {
      "type": "object",
      "properties": {
        "pct": {
          "type": "number"
        },
        "usd": {
          "type": "number"
        }
      }
    },
    "recommendation": {
      "type": "string",
      "description": "PROCEED | INVESTIGATE"
    }
  }
}

{
  "title": "Verify Fees",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "amountUsd"
  ],
  "properties": {
    "hasFx": {
      "type": "boolean",
      "description": "Cross-currency? Adds 0.40% FX fee."
    },
    "esgScore": {
      "type": "number",
      "description": "ESG score 0–100"
    },
    "amountUsd": {
      "type": "number",
      "description": "Settlement amount in USD"
    },
    "senderAddress": {
      "type": "string",
      "description": "Paying wallet address (optional). When given, the ESG fee is the payer's on-chain score, exactly as the router charges it."
    }
  }
}

{
  "type": "object",
  "properties": {
    "dpx": {
      "type": "object",
      "properties": {
        "rate": {
          "type": "string"
        },
        "feeUsd": {
          "type": "number"
        }
      }
    },
    "note": {
      "type": "string",
      "description": "Context note on comparison methodology"
    },
    "amountUsd": {
      "type": "number",
      "description": "Settlement amount compared"
    },
    "comparison": {
      "type": "object",
      "description": "Per-competitor comparison keyed by competitor ID",
      "additionalProperties": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "rate": {
            "type": "string"
          },
          "feeUsd": {
            "type": "number"
          },
          "dpxCheaper": {
            "type": "boolean"
          },
          "dpxSavings": {
            "type": "number"
          }
        }
      }
    }
  }
}

{
  "title": "Compare Fees to Competitors",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "amount",
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Destination currency code (USD, EUR, GBP, etc.)"
    },
    "from": {
      "type": "string",
      "description": "Source currency code (USD, EUR, GBP, BRL, etc.)"
    },
    "amount": {
      "type": "number",
      "description": "Settlement amount in source currency"
    }
  }
}

{
  "type": "object",
  "properties": {
    "options": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "rank": {
            "type": "number"
          },
          "token": {
            "type": "string"
          },
          "rationale": {
            "type": "string"
          },
          "settleBody": {
            "type": "object",
            "additionalProperties": true
          },
          "tokenAddress": {
            "type": "string"
          },
          "isCrossCurrency": {
            "type": "boolean"
          }
        }
      }
    },
    "ttlSeconds": {
      "type": "number"
    },
    "generatedAt": {
      "type": "string"
    },
    "routingAdvice": {
      "type": "object",
      "properties": {
        "rationale": {
          "type": "string"
        },
        "recommendation": {
          "type": "string",
          "description": "Top-ranked stablecoin (USDC, EURC, or USDT)"
        },
        "oracleStabilityScore": {
          "type": "number",
          "description": "Current oracle stability score 0–100"
        }
      }
    },
    "settleEndpoint": {
      "type": "string"
    }
  }
}

{
  "title": "Route Payment",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "amount"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Destination currency code (default: USD)"
    },
    "lei": {
      "type": "string",
      "description": "Counterparty LEI for enhanced compliance check (optional)"
    },
    "from": {
      "type": "string",
      "description": "Source currency code (default: USD)"
    },
    "amount": {
      "type": "number",
      "description": "Settlement amount in source currency"
    },
    "address": {
      "type": "string",
      "description": "Counterparty wallet address for compliance screen (optional but recommended)"
    }
  }
}

{
  "type": "object",
  "properties": {
    "ready": {
      "type": "boolean",
      "description": "True when decision is PROCEED"
    },
    "token": {
      "type": "string",
      "description": "Recommended stablecoin (USDC, EURC, or USDT)"
    },
    "oracle": {
      "type": "object",
      "additionalProperties": true
    },
    "decision": {
      "type": "string",
      "description": "PROCEED | HOLD | BLOCKED"
    },
    "compliance": {
      "type": "object",
      "additionalProperties": true
    },
    "settleBody": {
      "type": "object",
      "description": "Ready to POST to /settle (null if BLOCKED or HOLD)",
      "additionalProperties": true
    },
    "ttlSeconds": {
      "type": "number"
    },
    "estimatedNetUsd": {
      "type": "number",
      "description": "Estimated net received after all fees"
    }
  }
}

{
  "title": "Flow Compliance Check",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "settlements"
  ],
  "properties": {
    "settlements": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "amount",
          "sourceCurrency",
          "destinationCurrency",
          "recipientAddress"
        ],
        "properties": {
          "token": {
            "type": "string"
          },
          "amount": {
            "type": "number"
          },
          "sandbox": {
            "type": "boolean"
          },
          "sourceCurrency": {
            "type": "string"
          },
          "recipientAddress": {
            "type": "string"
          },
          "destinationCurrency": {
            "type": "string"
          }
        }
      },
      "maxItems": 50,
      "description": "Array of settlement request objects (same schema as the settle tool)"
    }
  }
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "index": {
            "type": "number"
          },
          "status": {
            "type": "number"
          }
        }
      }
    },
    "summary": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number"
        },
        "failed": {
          "type": "number"
        },
        "succeeded": {
          "type": "number"
        }
      }
    }
  }
}

{
  "title": "Batch Settlement",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "amount"
  ],
  "properties": {
    "amount": {
      "type": "number",
      "description": "Invoice amount in source currency"
    },
    "currency": {
      "type": "string",
      "description": "Source currency code (default: USD)"
    },
    "ttlSeconds": {
      "type": "number",
      "description": "Invoice TTL in seconds (default: 86400 = 24h)"
    },
    "callbackUrl": {
      "type": "string",
      "description": "URL to notify when invoice is paid"
    },
    "description": {
      "type": "string",
      "description": "Human-readable payment description"
    },
    "recipientAddress": {
      "type": "string",
      "description": "Payee wallet address (can also be provided at pay time)"
    },
    "destinationCurrency": {
      "type": "string",
      "description": "Destination currency (default: same as currency)"
    }
  }
}

{
  "type": "object",
  "properties": {
    "payUrl": {
      "type": "string",
      "description": "Direct URL to pay this invoice"
    },
    "status": {
      "type": "string",
      "description": "OPEN | PAID | EXPIRED"
    },
    "expiresAt": {
      "type": "string"
    },
    "invoiceId": {
      "type": "string",
      "description": "UUID — pass to invoice.get or invoice.pay"
    }
  }
}

{
  "title": "Create Invoice",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "invoiceId"
  ],
  "properties": {
    "invoiceId": {
      "type": "string",
      "description": "Invoice UUID returned by invoice.create"
    }
  }
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "amount": {
      "type": "number"
    },
    "payUrl": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "expiresAt": {
      "type": "string"
    }
  }
}

{
  "title": "Get Invoice",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "invoiceId"
  ],
  "properties": {
    "sandbox": {
      "type": "boolean",
      "description": "True for sandbox simulation. Default: true — set false only for live execution."
    },
    "invoiceId": {
      "type": "string",
      "description": "Invoice UUID to pay"
    },
    "recipientAddress": {
      "type": "string",
      "description": "Payee wallet address (required if not set in invoice)"
    }
  }
}

{
  "type": "object",
  "properties": {
    "invoiceId": {
      "type": "string"
    },
    "settlement": {
      "type": "object",
      "description": "Full settlement result from POST /settle",
      "additionalProperties": true
    }
  }
}

{
  "title": "Pay Invoice",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "HTTPS endpoint to receive settlement.completed events"
    },
    "events": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Event types (default: [\"settlement.completed\"])"
    },
    "invoiceId": {
      "type": "string",
      "description": "Only deliver the settlement of this invoice. Provide this or recipientAddress."
    },
    "recipientAddress": {
      "type": "string",
      "description": "Only deliver settlements to this recipient. Provide this or invoiceId — the agent rejects subscriptions with neither."
    }
  }
}

{
  "type": "object",
  "properties": {
    "events": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "webhookSecret": {
      "type": "string",
      "description": "HMAC secret — returned once, store immediately"
    },
    "subscriptionId": {
      "type": "string"
    }
  }
}

{
  "title": "Subscribe to Settlement Updates",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "fees": {
      "type": "object",
      "properties": {
        "totalPct": {
          "type": "number"
        },
        "esgFeePct": {
          "type": "number"
        },
        "baseRatePct": {
          "type": "number"
        }
      }
    },
    "esgScore": {
      "type": "number",
      "description": "Protocol ESG composite score 0–100"
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 analytics timestamp"
    },
    "oracleHealth": {
      "type": "object",
      "description": "Health status per oracle data source",
      "additionalProperties": true
    },
    "stabilityScore": {
      "type": "number",
      "description": "Current oracle stability score 0–100"
    },
    "settlementReady": {
      "type": "boolean",
      "description": "True if conditions are suitable for settlement"
    }
  }
}

{
  "title": "Analytics Overview",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "amount",
    "sourceCurrency",
    "destinationCurrency",
    "recipientAddress"
  ],
  "properties": {
    "amount": {
      "type": "number",
      "description": "Amount in source currency units"
    },
    "purpose": {
      "type": "string",
      "description": "Payment purpose: intercompany, vendor-payment, payroll, treasury"
    },
    "quoteId": {
      "type": "string",
      "description": "Pre-fetched quoteId from get_quote (optional — agent fetches live if omitted)"
    },
    "sandbox": {
      "type": "boolean",
      "description": "Sandbox mode — real calculations, no on-chain execution. Default: true."
    },
    "esgScore": {
      "type": "number",
      "description": "ESG score override 0–100 (testing only)"
    },
    "referenceId": {
      "type": "string",
      "description": "External reference ID (invoice number, TMS ID, etc.)"
    },
    "sourceCurrency": {
      "type": "string",
      "description": "Source currency: USD, EUR, GBP, USDC, EURC"
    },
    "recipientAddress": {
      "type": "string",
      "description": "On-chain recipient wallet address (0x...)"
    },
    "destinationCurrency": {
      "type": "string",
      "description": "Destination currency: USD, EUR, GBP, USDC, EURC"
    }
  }
}

{
  "type": "object",
  "properties": {
    "result": {
      "type": "object",
      "properties": {
        "status": {
          "enum": [
            "executed",
            "sandbox",
            "held",
            "failed"
          ],
          "type": "string"
        },
        "txHash": {
          "type": "string",
          "description": "On-chain transaction hash (if executed)"
        },
        "feesTotal": {
          "type": "number",
          "description": "Total fees in USD"
        },
        "netAmount": {
          "type": "number",
          "description": "Net amount delivered after fees"
        },
        "reasoning": {
          "type": "string",
          "description": "AI reasoning for settlement decision"
        },
        "timestamp": {
          "type": "string",
          "description": "ISO 8601 settlement timestamp"
        },
        "oracleScore": {
          "type": "number",
          "description": "Oracle score at time of settlement"
        },
        "oracleStatus": {
          "type": "string",
          "description": "Oracle status at time of settlement"
        },
        "settlementId": {
          "type": "string",
          "description": "Unique settlement ID (dpx_...)"
        }
      }
    },
    "summary": {
      "type": "string",
      "description": "Human-readable settlement outcome summary"
    },
    "httpStatus": {
      "type": "number",
      "description": "HTTP status from Settlement Agent"
    }
  }
}

{
  "title": "Execute Settlement",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "settlementId"
  ],
  "properties": {
    "settlementId": {
      "type": "string",
      "description": "Settlement ID from the settlement.execute tool (format: dpx_...)"
    }
  }
}

{
  "type": "object",
  "properties": {
    "httpStatus": {
      "type": "number",
      "description": "HTTP status from Settlement Agent"
    },
    "settlement": {
      "type": "object",
      "properties": {
        "amount": {
          "type": "number"
        },
        "status": {
          "enum": [
            "executed",
            "sandbox",
            "held",
            "failed",
            "pending"
          ],
          "type": "string"
        },
        "txHash": {
          "type": "string"
        },
        "esgScore": {
          "type": "number"
        },
        "feesTotal": {
          "type": "number"
        },
        "netAmount": {
          "type": "number"
        },
        "reasoning": {
          "type": "string"
        },
        "timestamp": {
          "type": "string"
        },
        "oracleStatus": {
          "type": "string"
        },
        "settlementId": {
          "type": "string"
        },
        "sourceCurrency": {
          "type": "string"
        },
        "destinationCurrency": {
          "type": "string"
        }
      }
    }
  }
}

{
  "title": "Settlement Status",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "instruction",
    "recipientAddress"
  ],
  "properties": {
    "sandbox": {
      "type": "boolean",
      "description": "Set false for live execution. Default: true"
    },
    "instruction": {
      "type": "string",
      "description": "Plain-English payment instruction, e.g. 'Pay Acme GmbH $25,000 USD for invoice #INV-2026-0042'"
    },
    "recipientAddress": {
      "type": "string",
      "description": "Recipient wallet address (0x...)"
    }
  }
}

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string"
    },
    "txHash": {
      "type": "string"
    },
    "feesTotal": {
      "type": "number"
    },
    "netAmount": {
      "type": "number"
    },
    "aiDecision": {
      "type": "string"
    },
    "aiConfidence": {
      "type": "number"
    },
    "settlementId": {
      "type": "string"
    }
  }
}

{
  "title": "Natural Language Settlement",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "screen_context",
    "amount",
    "recipient_address",
    "purpose"
  ],
  "properties": {
    "amount": {
      "type": "number",
      "description": "Payment amount in USD as shown on screen"
    },
    "purpose": {
      "type": "string",
      "description": "Payment purpose — e.g. vendor-invoice, contractor-payment, subscription, procurement"
    },
    "sandbox": {
      "type": "boolean",
      "description": "Set false for live execution. Default: true"
    },
    "screen_context": {
      "type": "string",
      "description": "Describe what is visible on screen — the payment form, vendor name, invoice number, or UI context. Used for audit trail."
    },
    "sender_address": {
      "type": "string",
      "description": "Paying wallet address (optional). When given, the quote uses the payer's on-chain ESG score and /settle returns router-exact fees."
    },
    "counterparty_name": {
      "type": "string",
      "description": "Vendor or payee name as shown on screen"
    },
    "recipient_address": {
      "type": "string",
      "description": "Recipient wallet address (0x...). If only bank/email visible, use settlement.nl instead."
    }
  }
}

{
  "type": "object",
  "properties": {
    "feeUsd": {
      "type": "number"
    },
    "netUsd": {
      "type": "number"
    },
    "reason": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "txHash": {
      "type": "string"
    },
    "decision": {
      "enum": [
        "EXECUTED",
        "ABORTED",
        "HOLD",
        "BLOCKED"
      ],
      "type": "string"
    },
    "aiDecision": {
      "type": "string"
    },
    "aiConfidence": {
      "type": "number"
    },
    "settlementId": {
      "type": "string"
    }
  }
}

{
  "title": "Computer-Use Payment",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [],
  "properties": {
    "rails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Specific rails to check: 'PIX', 'SEPA', 'FedACH', 'CHAPS', 'UPI', 'PromptPay'. Omit for all."
    },
    "region": {
      "type": "string",
      "description": "Filter by region: 'latam', 'europe', 'us', 'asia', 'uk'."
    }
  }
}

{
  "type": "object",
  "properties": {
    "rails": {
      "type": "object",
      "description": "Per-rail status map",
      "additionalProperties": true
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 timestamp"
    },
    "healthScore": {
      "type": "number",
      "description": "Composite rail health score 0–100"
    },
    "recommendation": {
      "type": "string",
      "description": "Settlement recommendation based on rail health"
    }
  }
}

{
  "title": "Rail Status Oracle",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "section": {
      "enum": [
        "all",
        "overview",
        "product",
        "traction",
        "market",
        "financials",
        "compliance",
        "raise",
        "founder",
        "risks"
      ],
      "type": "string",
      "description": "Which section to return. Default 'all' returns the complete memo."
    }
  }
}

{
  "type": "object",
  "properties": {
    "_meta": {
      "type": "object",
      "description": "Memo metadata",
      "additionalProperties": true
    },
    "raise": {
      "type": "object",
      "description": "Raise details",
      "additionalProperties": true
    },
    "risks": {
      "type": "object",
      "description": "Key risks",
      "additionalProperties": true
    },
    "market": {
      "type": "object",
      "description": "Market context",
      "additionalProperties": true
    },
    "founder": {
      "type": "object",
      "description": "Founder background",
      "additionalProperties": true
    },
    "product": {
      "type": "object",
      "description": "Product and technology",
      "additionalProperties": true
    },
    "overview": {
      "type": "object",
      "description": "Company overview",
      "additionalProperties": true
    },
    "traction": {
      "type": "object",
      "description": "Traction and metrics",
      "additionalProperties": true
    },
    "compliance": {
      "type": "object",
      "description": "Compliance posture",
      "additionalProperties": true
    },
    "financials": {
      "type": "object",
      "description": "Financial model",
      "additionalProperties": true
    }
  }
}

{
  "title": "Investment Context",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "window": {
      "enum": [
        "7d",
        "30d"
      ],
      "type": "string",
      "description": "Time window for metrics. \"7d\" = last 7 days, \"30d\" = last 30 days. Default: 30d."
    }
  }
}

{
  "type": "object",
  "properties": {
    "window": {
      "type": "string"
    },
    "peakDay": {
      "type": "object"
    },
    "summary": {
      "type": "string"
    },
    "services": {
      "type": "array"
    },
    "errorRate": {
      "type": "string"
    },
    "weeklyTrend": {
      "type": "array"
    },
    "dailyAverage": {
      "type": "number"
    },
    "totalRequests": {
      "type": "number"
    }
  }
}

{
  "title": "DPX Metrics",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "walletAddress"
  ],
  "properties": {
    "apiKey": {
      "type": "string",
      "description": "Optional: the DPX API key being registered for this integration. Stored as a hash — never logged in plaintext."
    },
    "walletAddress": {
      "type": "string",
      "description": "The client wallet address (0x...) that will send the $0.01 verification payment."
    }
  }
}

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "description": "Always \"pending\" on creation."
    },
    "payment": {
      "type": "object",
      "properties": {
        "to": {
          "type": "string",
          "description": "DPX treasury address to send USDC to."
        },
        "amount": {
          "type": "string",
          "description": "Amount in USDC (0.01)."
        },
        "network": {
          "type": "string",
          "description": "base-mainnet"
        }
      }
    },
    "polling": {
      "type": "object",
      "properties": {
        "url": {
          "type": "string"
        },
        "timeoutAt": {
          "type": "string"
        },
        "intervalSeconds": {
          "type": "number"
        }
      }
    },
    "expiresAt": {
      "type": "string",
      "description": "ISO timestamp — verification window closes after 24 hours."
    },
    "verificationId": {
      "type": "string",
      "description": "Session ID — use with integration.status to poll for payment confirmation."
    }
  }
}

{
  "title": "Verify Integration",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "verificationId returned by integration.verify."
    }
  }
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "pending",
        "verified",
        "expired"
      ],
      "type": "string",
      "description": "Current verification state."
    },
    "txHash": {
      "type": "string",
      "description": "Transaction hash of the $0.01 payment. Present when verified."
    },
    "message": {
      "type": "string"
    },
    "explorer": {
      "type": "string",
      "description": "Basescan URL for the verification transaction."
    },
    "verifiedAt": {
      "type": "string",
      "description": "ISO timestamp of on-chain confirmation. Present when status is \"verified\"."
    },
    "walletAddress": {
      "type": "string"
    }
  }
}

{
  "title": "Integration Status",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "tenant_id"
  ],
  "properties": {
    "tenant_id": {
      "type": "string",
      "description": "Your internal tenant or customer ID — returned in the callback so you can match the connection."
    }
  }
}

{
  "type": "object",
  "properties": {
    "scopes": {
      "type": "string",
      "description": "Requested OAuth scopes."
    },
    "tenant_id": {
      "type": "string"
    },
    "authorize_url": {
      "type": "string",
      "description": "Redirect the user to this URL to authorize DPX on their Ramp account."
    }
  }
}

{
  "title": "Connect Ramp",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "tenant_id"
  ],
  "properties": {
    "page_size": {
      "type": "number",
      "description": "Number of bills to analyse (default 100, max 500)."
    },
    "tenant_id": {
      "type": "string",
      "description": "Tenant ID of the connected Ramp account."
    }
  }
}

{
  "type": "object",
  "properties": {
    "crossBorder": {
      "type": "object",
      "description": "Wire and international bill totals."
    },
    "dpxOpportunity": {
      "type": "object",
      "description": "Estimated annual savings and DPX fees."
    },
    "topVendorsBySpend": {
      "type": "array",
      "description": "Top 10 vendors by total payment volume."
    }
  }
}

{
  "title": "Ramp Spend Analysis",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "tenant_id",
    "amount"
  ],
  "properties": {
    "amount": {
      "type": "string",
      "description": "Card spending cap (e.g. \"10000.00\")."
    },
    "currency": {
      "type": "string",
      "description": "Currency code (default USD)."
    },
    "reference": {
      "type": "string",
      "description": "Your internal reference ID."
    },
    "tenant_id": {
      "type": "string",
      "description": "Tenant ID of the connected Ramp account."
    },
    "display_name": {
      "type": "string",
      "description": "Card label visible in Ramp dashboard."
    },
    "merchant_scope": {
      "type": "string",
      "description": "Intended merchant name (informational)."
    }
  }
}

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "string"
    },
    "taskId": {
      "type": "string",
      "description": "Poll GET /ramp/agent-card/:taskId for card PAN/CVV."
    },
    "currency": {
      "type": "string"
    },
    "reference": {
      "type": "string"
    },
    "statusUrl": {
      "type": "string"
    }
  }
}

{
  "title": "Ramp Agent Card",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "tenant_id",
    "amount",
    "currency",
    "creditor_wallet",
    "creditor_name"
  ],
  "properties": {
    "amount": {
      "type": "string",
      "description": "Payment amount (e.g. \"50000.00\")."
    },
    "currency": {
      "type": "string",
      "description": "Source currency: USD or EUR."
    },
    "reference": {
      "type": "string",
      "description": "Your internal payment reference."
    },
    "tenant_id": {
      "type": "string",
      "description": "Tenant ID of the connected Ramp account."
    },
    "callback_url": {
      "type": "string",
      "description": "Webhook URL for pacs.002 delivery."
    },
    "creditor_lei": {
      "type": "string",
      "description": "Recipient LEI for GLEIF VoP (optional)."
    },
    "creditor_name": {
      "type": "string",
      "description": "Recipient name."
    },
    "merchant_scope": {
      "type": "string",
      "description": "Merchant name for Agent Card scope."
    },
    "creditor_wallet": {
      "type": "string",
      "description": "Recipient on-chain wallet address (0x...)."
    },
    "settlement_asset": {
      "type": "string",
      "description": "Settlement asset: USDC (default) or EURC."
    }
  }
}

{
  "type": "object",
  "properties": {
    "status": {
      "enum": [
        "SETTLED",
        "PENDING",
        "BLOCKED",
        "FAILED"
      ],
      "type": "string"
    },
    "iso20022": {
      "type": "object",
      "description": "pacs.002 status object."
    },
    "agentCard": {
      "type": "object"
    },
    "compliance": {
      "type": "object",
      "description": "FATF R16 + SFDR PAI indicators."
    },
    "settlement": {
      "type": "object"
    },
    "dpxPaymentId": {
      "type": "string"
    }
  }
}

{
  "title": "Ramp Settlement",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": true
}

{
  "type": "object",
  "required": [
    "counterpartyName",
    "amount"
  ],
  "properties": {
    "amount": {
      "type": "number",
      "description": "Payment amount in units of currency."
    },
    "currency": {
      "type": "string",
      "description": "ISO 4217 currency code. Defaults to \"USD\"."
    },
    "paymentType": {
      "enum": [
        "vendor_payment",
        "payroll",
        "intercompany",
        "other"
      ],
      "type": "string",
      "description": "Payment type — payroll automatically triggers PEP screen."
    },
    "isIndividual": {
      "type": "boolean",
      "description": "true if counterparty is an individual (triggers PEP screen). Defaults to false."
    },
    "sourceCountry": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 source country. Defaults to \"US\"."
    },
    "counterpartyLei": {
      "type": "string",
      "description": "Optional GLEIF LEI — enables UBO chain check and satisfies FATF R.16 originator identification."
    },
    "counterpartyName": {
      "type": "string",
      "description": "Legal name of the payment counterparty."
    },
    "counterpartyCountry": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 destination country (e.g. \"DE\", \"NG\", \"IR\")."
    }
  }
}

{
  "type": "object",
  "properties": {
    "checks": {
      "type": "object",
      "description": "fatfCountry, amountFlags, sanctions, pep, uboChain check details."
    },
    "_action": {
      "type": "string",
      "description": "Recommended action for the agent."
    },
    "fatfR16": {
      "type": "object",
      "description": "FATF R.16 satisfied status and basis."
    },
    "reasons": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Specific reasons for the decision."
    },
    "decision": {
      "enum": [
        "APPROVED",
        "FLAGGED",
        "BLOCKED"
      ],
      "type": "string",
      "description": "Compliance decision."
    },
    "riskScore": {
      "type": "number",
      "description": "Risk score 0–100."
    },
    "humanRequired": {
      "type": "boolean",
      "description": "true only for FLAGGED — APPROVED payments proceed automatically."
    }
  }
}

{
  "title": "Ramp Compliance Screen",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "origin": {
      "type": "string",
      "description": "Origin node ID. Call market.cascade with listNodes:true to discover valid IDs (e.g. \"geo.conflict\", \"climate.drought\", \"commodity.oil\", \"macro.rate_decision\")."
    },
    "eventType": {
      "type": "string",
      "description": "Free-text description of the specific event (e.g. \"Russia-Ukraine escalation\", \"Sahel drought season\", \"Fed emergency 75bps hike\")."
    },
    "listNodes": {
      "type": "boolean",
      "description": "If true, returns all valid origin node IDs and descriptions instead of running a cascade. Use this first to discover valid origin values."
    },
    "magnitude": {
      "type": "number",
      "description": "Shock magnitude 1–100. 100 = maximum plausible shock for this event type. 40–60 = significant but not extreme."
    },
    "horizonHours": {
      "type": "number",
      "description": "Forward time horizon in hours (1–720). Default: 168 (1 week). Use 24 for immediate cascade, 720 for full 30-day view."
    }
  }
}

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "object",
      "description": "Origin node metadata."
    },
    "cascade": {
      "type": "array",
      "description": "Time-ordered propagation chain — each entry has node, magnitude, arrivalHours, via path, and mechanism."
    },
    "eventType": {
      "type": "string",
      "description": "Event description provided."
    },
    "synthesis": {
      "type": "string",
      "description": "AI intelligence briefing on transmission paths, concentrated risk, feedback loops, and forward signals."
    },
    "computedAt": {
      "type": "string",
      "description": "ISO timestamp of computation."
    },
    "horizonHours": {
      "type": "number",
      "description": "Time horizon modeled."
    },
    "inputMagnitude": {
      "type": "number",
      "description": "Clamped input magnitude."
    }
  }
}

{
  "title": "Market Cascade (Butterfly Effect)",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "nodes": {
      "type": "object",
      "additionalProperties": true
    },
    "regime": {
      "type": "string",
      "description": "Network regime classification."
    },
    "threadHealth": {
      "type": "object",
      "additionalProperties": true
    },
    "networkHealth": {
      "type": "number",
      "description": "Composite network vitality score 0–100."
    },
    "fruitingBodyRisk": {
      "type": "object",
      "additionalProperties": true
    },
    "networkNarrative": {
      "type": "string"
    }
  }
}

{
  "title": "Mycelium Network Oracle",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "synthesis": {
      "type": "string",
      "description": "AI briefing on the most dangerous structural accumulations."
    },
    "faultLines": {
      "type": "array",
      "description": "Per-node: domain, label, stress, accumulationRate, yearsToRupture, tippingThreshold."
    },
    "systemStress": {
      "type": "number",
      "description": "Composite tectonic stress 0–100."
    },
    "ruptureSequence": {
      "type": "array",
      "description": "Ordered fault lines by proximity to rupture."
    }
  }
}

{
  "title": "Tectonic Stress Intelligence",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "origin",
    "magnitude"
  ],
  "properties": {
    "origin": {
      "type": "string",
      "description": "Origin node ID from the primary cascade (e.g. \"geo.conflict\", \"climate.drought\")."
    },
    "eventType": {
      "type": "string",
      "description": "Description of the primary event."
    },
    "magnitude": {
      "type": "number",
      "description": "Primary shock magnitude 1–100."
    },
    "elapsedHours": {
      "type": "number",
      "description": "Hours elapsed since the primary event. Default 24."
    },
    "horizonHours": {
      "type": "number",
      "description": "Forward horizon to model in hours. Default 4320 (6 months)."
    }
  }
}

{
  "type": "object",
  "properties": {
    "wave1": {
      "type": "object",
      "description": "Immediate (0–72h): rebound, amplified, structural nodes."
    },
    "wave2": {
      "type": "object",
      "description": "Policy response phase (1–4 weeks)."
    },
    "wave3": {
      "type": "object",
      "description": "Structural lock-in (1–6 months)."
    },
    "synthesis": {
      "type": "string"
    }
  }
}

{
  "title": "Aftershock Intelligence",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "origin": {
      "type": "string",
      "description": "Origin node ID. Call intelligence.contagion with listNodes:true to discover valid IDs."
    },
    "listNodes": {
      "type": "boolean",
      "description": "If true, returns all valid origin node IDs instead of running a simulation."
    },
    "magnitude": {
      "type": "number",
      "description": "Initial shock magnitude 1–100."
    }
  }
}

{
  "type": "object",
  "properties": {
    "systemR": {
      "type": "number",
      "description": "System-level R value. ≥1.0 means spreading."
    },
    "spreadMap": {
      "type": "array",
      "description": "Per-epoch infection state across all nodes."
    },
    "synthesis": {
      "type": "string"
    },
    "containment": {
      "type": "object",
      "description": "Forecast of when/if containment is achieved."
    },
    "superspreaders": {
      "type": "array",
      "description": "Nodes with highest R contribution."
    }
  }
}

{
  "title": "Contagion Network Intelligence",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "synthesis": {
      "type": "string"
    },
    "dangerZoneMatch": {
      "type": "object",
      "description": "Similarity to historical crisis resonance patterns."
    },
    "resonanceClusters": {
      "type": "array",
      "description": "Groups of 3+ signals in mutual resonance."
    },
    "amplificationFactor": {
      "type": "number",
      "description": "Constructive interference gain across dominant cluster."
    },
    "systemResonanceScore": {
      "type": "number",
      "description": "0–100. Higher = more dangerous in-phase alignment."
    }
  }
}

{
  "title": "Resonance Phase Intelligence",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "countries": {
      "type": "array",
      "description": "Per-country: gbvRiskScore, opportunityScore, LFPR gap, WBL index, GDP per capita, transmission mechanisms."
    },
    "synthesis": {
      "type": "string"
    },
    "regionalSummary": {
      "type": "object"
    }
  }
}

{
  "title": "Gender Risk Intelligence",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "regime": {
      "type": "string",
      "description": "STABLE / MODERATE / ELEVATED / SEVERE_DISRUPTION"
    },
    "keyRoutes": {
      "type": "array",
      "description": "Per-route disruption status and stress score."
    },
    "synthesis": {
      "type": "string",
      "description": "Narrative briefing on freight conditions and implications."
    },
    "energyCost": {
      "type": "object",
      "description": "Brent crude, diesel price, marine fuel proxy."
    },
    "freightModes": {
      "type": "array",
      "description": "Per-mode (ocean/air/truck/rail) cost index and stress signal."
    },
    "compositeScore": {
      "type": "number",
      "description": "Composite stress score 0–100 (higher = more stress)."
    },
    "settlementRelevance": {
      "type": "object",
      "description": "Invoice delay risk, trade finance stress, affected corridors."
    }
  }
}

{
  "title": "Shipping & Logistics Stress",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "dxy": {
      "type": "object",
      "description": "DXY value, trend, regime, and settlement impact summary."
    },
    "corridors": {
      "type": "array",
      "description": "Per-pair risk, spot rate, advice, and settlement cost."
    },
    "overallRisk": {
      "type": "string",
      "description": "FAVORABLE / NORMAL / MODERATE / HIGH / CRITICAL"
    },
    "bestCorridors": {
      "type": "array",
      "description": "Pairs with NORMAL or FAVORABLE risk — settle now."
    },
    "worstCorridors": {
      "type": "array",
      "description": "Pairs with HIGH or CRITICAL risk — delay or hedge."
    },
    "executiveSummary": {
      "type": "string",
      "description": "Plain-language summary of FX settlement conditions."
    },
    "recommendedActions": {
      "type": "array",
      "description": "Actionable guidance for treasury teams."
    }
  }
}

{
  "title": "FX Market Intelligence",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "instability": {
      "type": "object",
      "description": "Per-region (US/China/Russia/EU): stabilityScore, regimeRisk, keyRisks, synthesis."
    },
    "macroStress": {
      "type": "object",
      "description": "regime, score 0–100, creditSpreads, yieldCurve, signals, fxLeadSignal, synthesis."
    }
  }
}

{
  "title": "Macro Stress & Instability",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "signals": {
      "type": "array",
      "items": {
        "enum": [
          "climate",
          "climate-pulse",
          "earth-systems"
        ],
        "type": "string"
      },
      "description": "Subset of signals to return. Omit for all three."
    }
  }
}

{
  "type": "object",
  "properties": {
    "climate": {
      "type": "object",
      "description": "agriculturalZones, precipitationShift, foodInflationSignal, migrationPressure, synthesis."
    },
    "climatePulse": {
      "type": "object",
      "description": "regions, temperatureAnomaly, droughtIndex, heatwaveRisk, cropStressSignal."
    },
    "earthSystems": {
      "type": "object",
      "description": "earthHealthIndex, tippingPoints (9), proximityScores, catastropheRisk, synthesis."
    }
  }
}

{
  "title": "Climate Intelligence Suite",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "supplyChain": {
      "type": "object",
      "description": "pressureIndex, regime, chokepoints (6), tradeFlowSignals, settlementImpact, synthesis."
    },
    "energyTransition": {
      "type": "object",
      "description": "renewableShare, fossilDemandCurve, gridCarbonIntensity (US/EU/global), transitionVelocity, synthesis."
    }
  }
}

{
  "title": "Supply Chain & Energy Transition",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "sovereignDebt": {
      "type": "object",
      "description": "perCountry: debtGdpRatio, yieldDynamic, defaultRisk, contagionRisk. systemicScore, synthesis."
    },
    "currencyStress": {
      "type": "object",
      "description": "dollarRegime, g10Scores, emScores, capitalFlowDirection, corridorImpact, synthesis."
    }
  }
}

{
  "title": "Sovereign Debt & Currency Stress",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "waterRisk": {
      "type": "object",
      "description": "regions (6), stressScore, sectorExposure, tnfdAlignment, synthesis."
    },
    "biodiversity": {
      "type": "object",
      "description": "regions (8), iucnSignals, sectorDependency, sectorImpact, sfdrPai7, synthesis."
    }
  }
}

{
  "title": "Nature & Water Risk (TNFD)",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "originNode"
  ],
  "properties": {
    "magnitude": {
      "type": "number",
      "description": "Shock severity 1–10. Default 5."
    },
    "originNode": {
      "type": "string",
      "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."
    },
    "elapsedHours": {
      "type": "number",
      "description": "Hours since event origin — positions the propagation wave front. Default 0."
    }
  }
}

{
  "type": "object",
  "properties": {
    "nodeMap": {
      "type": "object",
      "description": "Full 25-node state after propagation."
    },
    "synthesis": {
      "type": "string",
      "description": "AI briefing on highest-impact transmission paths and concentrated risk."
    },
    "cascadeChain": {
      "type": "array",
      "description": "Time-ordered nodes hit: node, lag_hours, attenuatedMagnitude, transmissionPath."
    }
  }
}

{
  "title": "Butterfly Effect Cascade (POST)",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "politicalRisk": {
      "type": "object",
      "description": "Per-region: regimeStability, policyRisk, sanctionsExposure, corridorImpact, synthesis."
    },
    "transitionRisk": {
      "type": "object",
      "description": "carbonPriceExposure, strandedAssetRisk, policyVelocity, sectorImpacts, synthesis."
    }
  }
}

{
  "title": "Political & Transition Risk",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "Wallet address or LEI of the entity/portfolio to report on."
    },
    "signals": {
      "type": "array",
      "items": {
        "enum": [
          "sfdr",
          "financed-emissions",
          "taxonomy",
          "tnfd"
        ],
        "type": "string"
      },
      "description": "Subset of reports to generate. Omit for all four."
    }
  }
}

{
  "type": "object",
  "properties": {
    "sfdr": {
      "type": "object",
      "description": "SFDR PAI indicators table — 18 mandatory + 2 optional climate indicators."
    },
    "tnfdReport": {
      "type": "object",
      "description": "TNFD LEAP — locate (dependencies/impacts), evaluate (materiality), assess (scenarios), prepare (metrics)."
    },
    "financedEmissions": {
      "type": "object",
      "description": "PCAF Scope 3 Cat 15 — attributed emissions, data quality score, CSRD flag."
    },
    "taxonomyAlignment": {
      "type": "object",
      "description": "EU Taxonomy — aligned %, per-objective DNSH assessment, eligibility map."
    }
  }
}

{
  "title": "ESG Regulatory Reporting (SFDR/TNFD/EU Taxonomy)",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "format": {
      "enum": [
        "json",
        "report"
      ],
      "type": "string",
      "description": "json = machine-readable risk register (default). report = executive summary narrative via intelligence.synthesis endpoint."
    }
  }
}

{
  "type": "object",
  "properties": {
    "outlook": {
      "type": "object",
      "description": "30d, 60d, 90d macro regime probability."
    },
    "synthesis": {
      "type": "string",
      "description": "Full AI synthesis narrative."
    },
    "riskRegister": {
      "type": "array",
      "description": "Ranked active risks: domain, severity, confidence, signals, outlook."
    },
    "compositeScore": {
      "type": "number",
      "description": "Single 0–100 global macro risk score."
    },
    "corridorGuidance": {
      "type": "object",
      "description": "Per-corridor settlement recommendation based on composite signal."
    }
  }
}

{
  "title": "Composite Intelligence Report",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "topRisks": {
      "type": "array",
      "description": "Top 3 risks for next 48h: event, probability, impact, corridorsAffected."
    },
    "synthesis": {
      "type": "string",
      "description": "Full AI narrative."
    },
    "corridorAdvice": {
      "type": "object",
      "description": "Per major corridor: SETTLE_NOW / DELAY / AVOID + rationale."
    },
    "executionWindow": {
      "type": "object",
      "description": "Best 4h window in next 48h: startUtc, endUtc, compositeScore, rationale."
    },
    "settlementAdvice": {
      "type": "string",
      "description": "Go / No-go / Conditional with conditions."
    }
  }
}

{
  "title": "48-Hour Forward Macro Call",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "amountUsdc",
    "settlementDeadlineUtc"
  ],
  "properties": {
    "dryRun": {
      "type": "boolean",
      "description": "If true, returns analysis without any on-chain queries. Useful for planning. Default: false."
    },
    "amountUsdc": {
      "type": "number",
      "description": "Settlement amount in USDC. Minimum $50,000 for yield routing to be viable after gas costs."
    },
    "riskTolerance": {
      "enum": [
        "conservative",
        "moderate"
      ],
      "type": "string",
      "description": "conservative = sUSDS only (T-bill / RWA backed, instant exit). moderate = sUSDS with higher slippage tolerance (up to 0.15%). Default: conservative."
    },
    "settlementDeadlineUtc": {
      "type": "string",
      "description": "ISO 8601 UTC timestamp of when USDC must be ready for settlement (e.g. \"2026-06-15T20:00:00Z\"). The tool will recommend exiting 30 minutes before this."
    }
  }
}

{
  "type": "object",
  "properties": {
    "exitBy": {
      "type": "string",
      "description": "Recommended exit timestamp (30 min before deadline)."
    },
    "notViable": {
      "type": "boolean",
      "description": "True if net yield is negative (gas exceeds expected yield)."
    },
    "instrument": {
      "type": "string",
      "description": "Recommended instrument (currently always sUSDS)."
    },
    "windowHours": {
      "type": "number",
      "description": "Available window in hours (deadline minus now minus 30-min buffer)."
    },
    "netYieldUsdc": {
      "type": "number",
      "description": "Expected yield minus gas costs."
    },
    "currentApyPct": {
      "type": "number",
      "description": "Current Sky Savings Rate APY (live, from Sky Protocol)."
    },
    "amountReserved": {
      "type": "number",
      "description": "Amount kept in USDC regardless (10% floor)."
    },
    "amountRoutable": {
      "type": "number",
      "description": "Amount to deploy (90% of input, USDC). 10% stays in USDC."
    },
    "recommendation": {
      "enum": [
        "ROUTE",
        "HOLD",
        "INSUFFICIENT_WINDOW"
      ],
      "type": "string",
      "description": "ROUTE (deploy float), HOLD (stay in USDC), or INSUFFICIENT_WINDOW."
    },
    "gasEstimateUsdc": {
      "type": "number",
      "description": "Estimated Base L2 gas cost for entry + exit in USDC."
    },
    "risk_disclosure": {
      "type": "object",
      "properties": {
        "summary": {
          "type": "string"
        },
        "peg_risk": {
          "type": "string"
        },
        "liability": {
          "type": "string"
        },
        "bridge_risk": {
          "type": "string"
        },
        "liquidity_risk": {
          "type": "string"
        },
        "regulatory_note": {
          "type": "string"
        },
        "smart_contract_risk": {
          "type": "string"
        },
        "acknowledgement_required": {
          "type": "boolean"
        }
      },
      "description": "MUST be surfaced to the client before any action is taken."
    },
    "estimatedSlippage": {
      "type": "number",
      "description": "Estimated DEX slippage for USDC→USDS→USDC round trip (%)."
    },
    "expectedYieldUsdc": {
      "type": "number",
      "description": "Expected yield for this window at current APY."
    },
    "instrument_detail": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "chain": {
          "type": "string"
        },
        "issuer": {
          "type": "string"
        },
        "backing": {
          "type": "string"
        },
        "us_persons": {
          "type": "string"
        },
        "audit_status": {
          "type": "string"
        },
        "depeg_history": {
          "type": "string"
        },
        "exit_mechanism": {
          "type": "string"
        }
      },
      "description": "Background on the recommended instrument."
    },
    "slippageGuardTripped": {
      "type": "boolean",
      "description": "True if slippage > 0.1% — recommendation will be HOLD."
    }
  },
  "description": "Yield routing analysis. Check recommendation field before acting."
}

{
  "title": "Treasury Yield Routing",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "uetr"
  ],
  "properties": {
    "uetr": {
      "type": "string",
      "description": "RFC 4122 UUID UETR assigned at payment initiation, e.g. \"97ed4827-7b6f-4491-a06f-b548d5a7512d\"."
    }
  }
}

{
  "type": "object",
  "properties": {
    "uetr": {
      "type": "string",
      "description": "The UETR provided."
    },
    "pacs002": {
      "type": "object",
      "description": "Full ISO 20022 pacs.002 payload for gpi Tracker submission.",
      "additionalProperties": true
    },
    "gpiStatus": {
      "type": "string",
      "description": "ACCP | PDNG | RJCT"
    },
    "dpxPaymentId": {
      "type": "string",
      "description": "DPX internal payment ID."
    }
  }
}

{
  "title": "SWIFT GPI Tracking",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "agent_id",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Human-readable policy name"
    },
    "agent_id": {
      "type": "string",
      "description": "Stable identifier for the agent or org (wallet address, session prefix, org slug, etc.)"
    },
    "max_per_tx": {
      "type": "number",
      "description": "USD ceiling per single transaction. Payments above this are BLOCKED."
    },
    "max_per_day": {
      "type": "number",
      "description": "USD rolling daily ceiling. Payments that would exceed this are HOLDed."
    },
    "blocked_regions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "ISO 3166-1 alpha-2 country codes to block."
    },
    "allowed_purposes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "If set, only payments with a purpose in this list are allowed."
    },
    "require_hold_above": {
      "type": "number",
      "description": "Route to HOLD queue for human review if amount exceeds this threshold."
    },
    "require_oracle_stable": {
      "type": "boolean",
      "description": "If true, HOLD on CAUTION as well as UNSTABLE oracle status."
    },
    "blocked_counterparties": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Wallet addresses or LEIs to block."
    }
  }
}

{
  "title": "Create Policy",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "agent_id",
    "amount_usd"
  ],
  "properties": {
    "purpose": {
      "type": "string",
      "description": "Payment purpose string"
    },
    "agent_id": {
      "type": "string",
      "description": "Agent identifier — must match the agent_id used in policy.create"
    },
    "recipient": {
      "type": "string",
      "description": "Recipient wallet address"
    },
    "amount_usd": {
      "type": "number",
      "description": "Proposed payment amount in USD"
    },
    "session_id": {
      "type": "string",
      "description": "Task or session grouping ID for ledger tracking."
    },
    "to_currency": {
      "type": "string",
      "description": "Destination currency code (e.g. EUR, GBP)"
    },
    "counterparty": {
      "type": "string",
      "description": "Counterparty name or LEI"
    },
    "delegation_id": {
      "type": "string",
      "description": "If acting under a delegation from a parent agent, provide the delegation ID."
    },
    "oracle_status": {
      "type": "string",
      "description": "Current oracle status — STABLE, CAUTION, or UNSTABLE. Get from get_reliability."
    }
  }
}

{
  "title": "Check Policy",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "parent_agent_id",
    "child_agent_id"
  ],
  "properties": {
    "max_total": {
      "type": "number",
      "description": "Lifetime spending ceiling for this delegation"
    },
    "policy_id": {
      "type": "string",
      "description": "Policy ID to inherit (optional — inherits parent policy if omitted)"
    },
    "expires_at": {
      "type": "number",
      "description": "Unix timestamp (ms) when this delegation expires. Omit for no expiry."
    },
    "max_per_tx": {
      "type": "number",
      "description": "Maximum USD per transaction for the sub-agent"
    },
    "child_agent_id": {
      "type": "string",
      "description": "The sub-agent receiving delegated authority"
    },
    "parent_agent_id": {
      "type": "string",
      "description": "The authorising (parent) agent ID"
    }
  }
}

{
  "title": "Delegate Policy",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "agent_id",
    "amount_usd"
  ],
  "properties": {
    "sandbox": {
      "type": "boolean",
      "description": "True if this was a sandbox settlement"
    },
    "tx_hash": {
      "type": "string",
      "description": "On-chain transaction hash (if live)"
    },
    "agent_id": {
      "type": "string",
      "description": "Agent that executed the payment"
    },
    "policy_id": {
      "type": "string",
      "description": "Policy ID that governed this payment"
    },
    "recipient": {
      "type": "string",
      "description": "Recipient wallet address"
    },
    "amount_usd": {
      "type": "number",
      "description": "Amount paid in USD"
    },
    "session_id": {
      "type": "string",
      "description": "Task or session ID for grouping (use the same ID for all payments in one agent run)"
    },
    "to_currency": {
      "type": "string",
      "description": "Destination currency (default: USD)"
    },
    "counterparty": {
      "type": "string",
      "description": "Counterparty name"
    },
    "task_context": {
      "type": "string",
      "description": "Plain-text description of what task triggered this payment"
    },
    "delegation_id": {
      "type": "string",
      "description": "Delegation ID if acting under delegated authority"
    },
    "from_currency": {
      "type": "string",
      "description": "Source currency (default: USD)"
    },
    "oracle_status": {
      "type": "string",
      "description": "Oracle status at time of payment (STABLE / CAUTION / UNSTABLE)"
    },
    "settlement_id": {
      "type": "string",
      "description": "Settlement ID returned by the settle tool"
    },
    "compliance_decision": {
      "type": "string",
      "description": "Compliance decision at time of payment (PROCEED / HOLD / BLOCKED)"
    }
  }
}

{
  "title": "Create Receipt",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "session_id"
  ],
  "properties": {
    "session_id": {
      "type": "string",
      "description": "Session or task ID — the same ID used in receipt.create calls"
    }
  }
}

{
  "title": "Ledger Session",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max results to return (default 3, max 5)."
    },
    "query": {
      "type": "string",
      "description": "Keywords to search — e.g. \"how to settle\", \"esg fee formula\", \"butterfly cascade\", \"compliance screen\"."
    }
  }
}

{
  "title": "Search Documentation",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "positions"
  ],
  "properties": {
    "positions": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Array of net positions. Each: { corridor: \"USD-BRL\", netAmountUsd: 2300000, recipientAddress?: \"0x...\" }"
    },
    "settlementDate": {
      "type": "string",
      "description": "Settlement date ISO string (defaults to today UTC). E.g. \"2026-08-09\"."
    }
  }
}

{
  "title": "Card Positions",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "positions"
  ],
  "properties": {
    "sandbox": {
      "type": "boolean",
      "description": "true = test mode, no on-chain execution. Default true — set false only for live execution."
    },
    "positions": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Array of net positions. Each: { corridor: \"USD-BRL\", netAmountUsd: 2300000, recipientAddress: \"0x...\" }. recipientAddress is required for every position."
    }
  }
}

{
  "title": "Card Settlement",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "title": "Compute Models",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "task"
  ],
  "properties": {
    "task": {
      "type": "string",
      "description": "Description of the task — e.g. \"summarize a financial document\", \"write Python code\", \"translate from French\", \"reason through a math problem\"."
    },
    "speed": {
      "type": "boolean",
      "description": "true = prefer fastest model over most capable. Default false."
    }
  }
}

{
  "title": "Compute Cost",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "task"
  ],
  "properties": {
    "task": {
      "type": "string",
      "description": "Plain-language description of what the model should do. Used for model selection."
    },
    "messages": {
      "type": "array",
      "description": "Optional. Full message array in OpenAI format [{role, content}]. If omitted, task is sent as a user message."
    },
    "preferSpeed": {
      "type": "boolean",
      "description": "true = use the fastest available free model regardless of task type. Default false."
    }
  }
}

{
  "title": "Compute Routing",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "apiKey": {
      "type": "string",
      "description": "DPX Reports API key. Alternatively, set Authorization: Bearer <key> in the calling context."
    }
  }
}

{
  "title": "Climate Risk Report",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "apiKey": {
      "type": "string",
      "description": "DPX Reports API key."
    }
  }
}

{
  "title": "Macro Report",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "lei": {
      "type": "string",
      "description": "Optional GLEIF LEI for SFDR PAI report."
    },
    "apiKey": {
      "type": "string",
      "description": "DPX Reports API key."
    },
    "address": {
      "type": "string",
      "description": "Wallet address or on-chain entity address to score."
    }
  }
}

{
  "title": "ESG Report",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "lei": {
      "type": "string",
      "description": "GLEIF LEI of the entity to screen."
    },
    "name": {
      "type": "string",
      "description": "Entity name to screen (if no LEI). One of lei or name required."
    },
    "apiKey": {
      "type": "string",
      "description": "DPX Reports API key."
    }
  }
}

{
  "title": "Compliance Report",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "apiKey": {
      "type": "string",
      "description": "DPX Reports API key."
    },
    "period": {
      "type": "string",
      "description": "ISO month (YYYY-MM). Defaults to current month."
    }
  }
}

{
  "title": "Treasury Report",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "positions"
  ],
  "properties": {
    "apiKey": {
      "type": "string",
      "description": "DPX Reports API key."
    },
    "scenario": {
      "type": "string",
      "description": "Optional named commodity stress scenario (e.g. la_nina_moderate, gulf_hurricane_major) applied on top of any commodity positions."
    },
    "positions": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Up to 20 positions. Each item: { type: \"commodity\"|\"currency_pair\"|\"sovereign\"|\"sector\"|\"entity\", symbol?, from?, to?, country?, name?, geography?, address?, weight? }."
    }
  }
}

{
  "title": "Scenario Brief",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "entity"
  ],
  "properties": {
    "entity": {
      "type": "string",
      "description": "LEI or wallet address of the entity to screen."
    },
    "articleTarget": {
      "enum": [
        "6",
        "8",
        "9"
      ],
      "type": "string",
      "description": "Target SFDR article classification to assess against. Default: \"8\"."
    }
  }
}

{
  "type": "object",
  "properties": {
    "dnsh": {
      "type": "object",
      "description": "Do No Significant Harm assessment across 6 environmental objectives."
    },
    "paiFlags": {
      "type": "array",
      "description": "18 mandatory PAI indicators with flag, value, threshold, and pass/fail."
    },
    "synthesis": {
      "type": "string",
      "description": "Plain-language SFDR compliance narrative."
    },
    "classification": {
      "type": "string",
      "description": "Article 6 / 8 / 9 classification result."
    }
  }
}

{
  "title": "SFDR Article 8/9 Screen",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "entities"
  ],
  "properties": {
    "entities": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "LEIs, wallet addresses, or company names. Max 50."
    },
    "reportDate": {
      "type": "string",
      "description": "ISO date for the report reference period (default: today)."
    }
  }
}

{
  "type": "object",
  "properties": {
    "paiTable": {
      "type": "array",
      "description": "SFDR Annex I table rows — indicator, value, unit, data source, coverage."
    },
    "synthesis": {
      "type": "string",
      "description": "Narrative for the PAI statement."
    },
    "portfolioScore": {
      "type": "number",
      "description": "Aggregate PAI composite score 0–100."
    }
  }
}

{
  "title": "SFDR Annex I PAI Report",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "entity"
  ],
  "properties": {
    "entity": {
      "type": "string",
      "description": "LEI, wallet address, or company name of the vendor."
    },
    "amountUsd": {
      "type": "number",
      "description": "Payment amount in USD — scales the risk threshold (larger payments trigger higher scrutiny). Optional."
    }
  }
}

{
  "type": "object",
  "properties": {
    "flags": {
      "type": "array",
      "description": "Active risk flags with severity and source."
    },
    "esgScore": {
      "type": "number",
      "description": "ESG composite 0–100."
    },
    "riskTier": {
      "type": "string",
      "description": "LOW / MEDIUM / HIGH / CRITICAL"
    },
    "synthesis": {
      "type": "string",
      "description": "Plain-language vendor risk narrative."
    },
    "recommendation": {
      "type": "string",
      "description": "PROCEED / PROCEED_WITH_MONITORING / HOLD / BLOCK"
    },
    "complianceScore": {
      "type": "number",
      "description": "AML/sanctions/PEP composite 0–100."
    }
  }
}

{
  "title": "Vendor Risk Score",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "entity"
  ],
  "properties": {
    "entity": {
      "type": "string",
      "description": "Wallet address, LEI, or name of the counterparty to screen."
    },
    "purpose": {
      "type": "string",
      "description": "Payment purpose — used for behavioural context. Optional."
    },
    "amountUsd": {
      "type": "number",
      "description": "Transaction amount — used for velocity profiling. Optional."
    }
  }
}

{
  "type": "object",
  "properties": {
    "decision": {
      "type": "string",
      "description": "CLEAR / REVIEW / BLOCK"
    },
    "narrative": {
      "type": "string",
      "description": "Structured compliance narrative for audit record."
    },
    "confidence": {
      "type": "number",
      "description": "Decision confidence 0–1."
    },
    "behavioural": {
      "type": "object",
      "description": "Velocity flags, counterparty network risk, anomaly signals."
    },
    "sanctionHits": {
      "type": "array",
      "description": "Matched sanctions list entries with list name and match score."
    }
  }
}

{
  "title": "AML Screen",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "walletAddress"
  ],
  "properties": {
    "expectedLei": {
      "type": "string",
      "description": "Expected LEI for exact-match verification. Optional."
    },
    "expectedName": {
      "type": "string",
      "description": "Expected legal entity name for name-match verification. Optional."
    },
    "walletAddress": {
      "type": "string",
      "description": "Payee wallet address to verify."
    }
  }
}

{
  "type": "object",
  "properties": {
    "verified": {
      "type": "boolean",
      "description": "True if payee identity confirmed."
    },
    "confidence": {
      "type": "number",
      "description": "Match confidence 0–1."
    },
    "attestation": {
      "type": "string",
      "description": "Signed verification receipt for audit."
    },
    "identityFields": {
      "type": "object",
      "description": "Confirmed fields: lei, entityName, jurisdiction, esgTier."
    }
  }
}

{
  "title": "Verification of Payee",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "entity"
  ],
  "properties": {
    "depth": {
      "type": "number",
      "description": "Supply chain depth to trace (1 = direct suppliers, 2 = tier-2). Default 1. Max 2."
    },
    "entity": {
      "type": "string",
      "description": "LEI or wallet address of the focal company."
    }
  }
}

{
  "type": "object",
  "properties": {
    "tiers": {
      "type": "array",
      "description": "Per-tier: nodes, avgEsgScore, highRiskNodes, sfdrPaiFlags."
    },
    "synthesis": {
      "type": "string",
      "description": "Plain-language supply chain ESG narrative."
    },
    "scope3Estimate": {
      "type": "object",
      "description": "PCAF Scope 3 Category 1 estimate — attributed emissions."
    },
    "supplyChainScore": {
      "type": "number",
      "description": "Aggregate supply chain ESG composite 0–100."
    }
  }
}

{
  "title": "Supply Chain ESG Screen",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "score": {
      "type": "number",
      "description": "Chaos index 0–100 (higher = more chaotic)."
    },
    "trend": {
      "type": "string",
      "description": "IMPROVING / STABLE / DETERIORATING"
    },
    "layers": {
      "type": "array",
      "description": "Per-layer contribution: signal, score, weight, direction."
    },
    "regime": {
      "type": "string",
      "description": "CALM / ELEVATED / VOLATILE / HIGH / CRITICAL"
    },
    "keyDrivers": {
      "type": "array",
      "description": "Top 3 factors currently driving the score."
    }
  }
}

{
  "title": "Global Chaos Score",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "counterparty",
    "amountUsd"
  ],
  "properties": {
    "currency": {
      "type": "string",
      "description": "Source currency (default: USD)."
    },
    "amountUsd": {
      "type": "number",
      "description": "Settlement amount in USD."
    },
    "counterparty": {
      "type": "string",
      "description": "Payee wallet address."
    }
  }
}

{
  "type": "object",
  "properties": {
    "gates": {
      "type": "object",
      "description": "oracle: {status, score}, compliance: {tier, flags}, sfdr: {paiFlags}."
    },
    "verdict": {
      "type": "string",
      "description": "PROCEED / CAUTION / HOLD"
    },
    "rationale": {
      "type": "string",
      "description": "Plain-language reason for verdict."
    }
  }
}

{
  "title": "Settlement Gate",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Plain-language summary of which markets are most stressed."
    },
    "symbols": {
      "type": "array",
      "description": "Per-symbol: symbol, signal (RED/YELLOW/GREEN), urgency, primaryDriver, score."
    }
  }
}

{
  "title": "Commodity Heat Check",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "portfolio"
  ],
  "properties": {
    "horizon": {
      "enum": [
        "30d",
        "60d",
        "90d"
      ],
      "type": "string",
      "description": "Forecast horizon for risk assessment. Default 90d."
    },
    "portfolio": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Array of {symbol: \"WHEAT\", positionUsd: 500000}. Symbols: WHEAT · CORN · SOYB · COFFEE · COCOA · COTTON · SUGAR · WTI · NG · COPPER · LUMBER."
    }
  }
}

{
  "type": "object",
  "properties": {
    "disclosure": {
      "type": "string",
      "description": "Draft TCFD disclosure narrative for the portfolio."
    },
    "physicalRisk": {
      "type": "object",
      "description": "Acute and chronic physical risk scores per commodity, mapped to TCFD categories."
    },
    "portfolioScore": {
      "type": "number",
      "description": "Aggregate TCFD physical risk score 0–100."
    },
    "transitionRisk": {
      "type": "object",
      "description": "Policy, technology, market, and reputation transition risk signals."
    }
  }
}

{
  "title": "TCFD Physical Risk Report",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "webhookUrl",
    "symbols"
  ],
  "properties": {
    "alertOn": {
      "enum": [
        "signal_change",
        "confidence_drop",
        "climate_stress"
      ],
      "type": "string",
      "description": "Trigger type. signal_change = any BULLISH/BEARISH/NEUTRAL flip. confidence_drop = confidence falls below threshold. climate_stress = climateScore crosses level. Default: signal_change."
    },
    "symbols": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Commodity symbols to monitor. E.g. [\"WHEAT\", \"WTI\"]. Use [\"*\"] for all 11."
    },
    "threshold": {
      "type": "number",
      "description": "For confidence_drop: minimum confidence floor (0–1). For climate_stress: score level (0–100). Not used for signal_change."
    },
    "webhookUrl": {
      "type": "string",
      "description": "HTTPS URL to receive POST alerts."
    }
  }
}

{
  "type": "object",
  "properties": {
    "alertOn": {
      "type": "string"
    },
    "symbols": {
      "type": "array"
    },
    "webhookUrl": {
      "type": "string"
    },
    "subscriptionId": {
      "type": "string",
      "description": "Subscription ID for updates and cancellation."
    }
  }
}

{
  "title": "Commodity Alert Subscription",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "pain001Xml"
  ],
  "properties": {
    "sandbox": {
      "type": "boolean",
      "description": "Pass through to settlement.execute as sandbox mode. Default true."
    },
    "pain001Xml": {
      "type": "string",
      "description": "Raw pain.001 XML string."
    },
    "validateOnly": {
      "type": "boolean",
      "description": "If true, parse and validate without returning a settle body. Default false."
    }
  }
}

{
  "type": "object",
  "properties": {
    "payments": {
      "type": "array",
      "description": "Parsed payment instructions with amount, currency, creditor, debtor."
    },
    "settleBody": {
      "type": "object",
      "description": "Structured body ready for settlement.execute. Null if validateOnly=true."
    },
    "validationErrors": {
      "type": "array",
      "description": "Schema or business-rule validation errors, if any."
    }
  }
}

{
  "title": "ISO 20022 Payment Intake",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "amountUsd"
  ],
  "properties": {
    "amountUsd": {
      "type": "number",
      "description": "Settlement amount in USD."
    },
    "sourceCurrency": {
      "type": "string",
      "description": "Source currency (default: USD)."
    },
    "destinationCurrency": {
      "type": "string",
      "description": "Destination currency (default: USD)."
    }
  }
}

{
  "type": "object",
  "properties": {
    "brief": {
      "type": "string",
      "description": "Plain-language settlement brief."
    },
    "oracle": {
      "type": "object",
      "description": "status, score, reasoning."
    },
    "compliance": {
      "type": "object",
      "description": "tier, flags, amlStatus."
    },
    "stablecoin": {
      "type": "string",
      "description": "Recommended stablecoin for this settlement."
    },
    "feeEstimate": {
      "type": "object",
      "description": "totalBps, grossUsd, netUsd, intelligenceFee."
    }
  }
}

{
  "title": "Settlement Dry Run",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "paymentInstruction"
  ],
  "properties": {
    "sandbox": {
      "type": "boolean",
      "description": "If true, oracle and compliance run live but no on-chain execution. Default true."
    },
    "oauthToken": {
      "type": "string",
      "description": "Client's Kyriba OAuth bearer token. Never stored by DPX."
    },
    "paymentInstruction": {
      "type": "object",
      "description": "Kyriba SPI payment instruction object — amount, currency, counterparty, valueDate."
    }
  }
}

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "description": "AUTHORIZED / SANDBOX / HELD / REVIEW / FAILED"
    },
    "execution": {
      "type": "object",
      "description": "On-chain execution params (sender-funded — client calls approve() + settle())."
    },
    "kyribaRef": {
      "type": "string",
      "description": "Kyriba-format confirmation reference."
    },
    "settlementId": {
      "type": "string",
      "description": "DPX settlement ID."
    }
  }
}

{
  "title": "Kyriba TMS Integration",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "originatorAddress",
    "beneficiaryAddress",
    "amountUsd"
  ],
  "properties": {
    "purpose": {
      "type": "string",
      "description": "Payment purpose code."
    },
    "amountUsd": {
      "type": "number",
      "description": "Transfer amount in USD."
    },
    "originatorLei": {
      "type": "string",
      "description": "Originator LEI. Optional."
    },
    "beneficiaryLei": {
      "type": "string",
      "description": "Beneficiary LEI. Optional."
    },
    "originatorName": {
      "type": "string",
      "description": "Legal name of originator entity. Optional if LEI provided."
    },
    "beneficiaryName": {
      "type": "string",
      "description": "Legal name of beneficiary entity. Optional if LEI provided."
    },
    "originatorAddress": {
      "type": "string",
      "description": "Originator wallet address."
    },
    "beneficiaryAddress": {
      "type": "string",
      "description": "Beneficiary wallet address."
    }
  }
}

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "description": "RECORDED / TRANSMITTED / PENDING_ACK"
    },
    "attestation": {
      "type": "string",
      "description": "Signed compliance attestation."
    },
    "travelRuleId": {
      "type": "string",
      "description": "FATF R16 Travel Rule record ID."
    }
  }
}

{
  "title": "Travel Rule Compliance",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}