For AI Developers & Treasury System Integrators
AGENT
INTEGRATION
Five paths to connect AI agents to the DPX stablecoin protocol — from a single curl call to a full agentic treasury loop. No authentication required for read operations.
What an Agent Can Do with DPX
DPX exposes a live, no-auth API surface purpose-built for agentic use. Any AI agent with HTTP access can immediately:
Price a settlement
Get an exact fee breakdown for any cross-border treasury transfer — core fee, FX spread, ESG fee, license fee — with a quoteId valid for 300 seconds.
Score a counterparty's ESG
Pull live E, S, G scores from 6 institutional data sources for any entity. ESG score directly affects the DPX fee — better scores mean lower cost.
Check oracle stability
Before any large settlement, an agent should check the stability oracle. It returns a 6-tier score with peg deviation, data source consensus, and a recommended action.
Verify fees on-chain
Confirm that the fee quoted matches what will be charged on-chain before executing — a critical step for any autonomous treasury agent.
Execute settlement (beta)
With beta access, an agent can execute on-chain settlement via the DPXSettlementRouter on Base mainnet. Supports sandbox mode for testing without execution.
Compare vs. SWIFT/Wise
Get a real-time fee comparison against Stripe, Wise, and SWIFT correspondent banking for the same transaction — useful for treasury agent reporting.
01 MCP — Claude Desktop & Claude Agents
Best for
Claude Desktop users and developers building agents with the Anthropic SDK. Native tool use — no wrapper needed.
DPX ships a Model Context Protocol (MCP) server with 8 native tools. Drop it into Claude Desktop's config and the tools are immediately available in every conversation.
Add to Claude Desktop
{
"mcpServers": {
"dpx": {
"command": "node",
"args": ["/path/to/dpx-mcp-server/index.js"],
"env": {}
}
}
}
Available MCP Tools
get_manifestProtocol capabilities, contract addresses, supported currenciesget_quoteFull fee breakdown — core, FX, ESG, license — with quoteIdget_esg_scoreLive E, S, G scores from 6 institutional sourcesget_reliabilityStability signals, peg deviation, oracle consensusget_fee_scheduleComplete fee table for all settlement tiersverify_feesConfirm on-chain fees match the quote before executionget_oracle_statusRaw oracle output from all 14 data sourcescompare_to_competitorsDPX vs. Stripe, Wise, SWIFT for a given transactionExample Prompts for Claude
02 OpenAPI — Any Agent Framework
Best for
Framework-agnostic integration. Import the schema into any OpenAPI-compatible agent, tool builder, or treasury system.
The DPX OpenAPI 3.0 schema is available at /openapi.json. Any system that can consume an OpenAPI schema can immediately discover and call all DPX endpoints — no manual tool definition required.
# Get the full OpenAPI schema
curl "https://dpx-docs.pages.dev/openapi.json"
# Price a settlement (no auth)
curl "https://stability.untitledfinancial.com/quote?amountUsd=5000000&hasFx=true&esgScore=75"
# Get ESG score
curl "https://esg.untitledfinancial.com/esg-score"
# Check stability
curl "https://stability.untitledfinancial.com/reliability"
# Sandbox mode — real fee calculation, no execution
curl "https://stability.untitledfinancial.com/quote?amountUsd=5000000&hasFx=true&esgScore=75&sandbox=true"
Agent Discovery Files
These standard files allow agents to self-discover the protocol without manual configuration:
| File | Standard | Purpose |
|---|---|---|
/llms.txt |
llmstxt.org | Navigation index — all pages summarized for LLM context |
/llms-full.txt |
llmstxt.org | Complete documentation compiled for single-context loading |
/openapi.json |
OpenAPI 3.0 | Machine-readable API schema for any agent or tool builder |
/.well-known/ai-plugin.json |
OpenAI plugin | Plugin manifest — used by ChatGPT Actions and compatible agents |
03 GPT Actions — Custom ChatGPT Treasury Agent
Best for
Treasury teams already using ChatGPT who want a custom GPT that can price, verify, and report on DPX settlements.
Create a custom GPT at chat.openai.com → Explore GPTs → Create → Configure → Actions → Import from URL:
https://dpx-docs.pages.dev/openapi.json
Recommended GPT System Prompt
You are a DPX treasury assistant for [Your Organization].
Use the DPX tools to:
- Price cross-border settlements (always call getDPXQuote first)
- Check oracle stability before large transfers
- Score counterparty ESG ratings
- Compare DPX fees to Stripe, Wise, and SWIFT
- Verify fee quotes before execution
Always show:
- Full fee breakdown (core, FX, ESG, license fees)
- quoteId (expires in 300 seconds)
- Stability score before recommending execution
- Savings vs. SWIFT for the same amount
Use sandbox=true unless the user explicitly confirms execution.
Amounts are in USD. ESG score is 0–100 (higher = lower fees).
04 LangChain — Python Treasury Agent
Best for
Python developers building autonomous treasury agents, multi-step settlement workflows, or integrating DPX into existing LangChain pipelines.
from langchain.tools import tool
import requests
BASE = "https://stability.untitledfinancial.com"
ESG = "https://esg.untitledfinancial.com"
@tool
def get_dpx_quote(amount_usd: float, has_fx: bool = True,
esg_score: int = 50) -> dict:
"""Price a DPX cross-border settlement. Returns fee breakdown + quoteId."""
r = requests.get(f"{BASE}/quote", params={
"amountUsd": amount_usd, "hasFx": has_fx,
"esgScore": esg_score, "sandbox": True
})
return r.json()
@tool
def get_stability() -> dict:
"""Check DPX oracle stability. Returns 6-tier score + peg status."""
return requests.get(f"{BASE}/reliability").json()
@tool
def get_esg_score(entity: str = "") -> dict:
"""Get live ESG score (E, S, G) from 6 institutional sources."""
params = {"entity": entity} if entity else {}
return requests.get(f"{ESG}/esg-score", params=params).json()
@tool
def verify_fees(quote_id: str) -> dict:
"""Verify that on-chain fees match the quoted amount before settlement."""
return requests.get(f"{BASE}/verify-fees",
params={"quoteId": quote_id}).json()
# Build agent
from langchain.agents import initialize_agent, AgentType
from langchain_anthropic import ChatAnthropic
tools = [get_dpx_quote, get_stability, get_esg_score, verify_fees]
llm = ChatAnthropic(model="claude-opus-4-5")
agent = initialize_agent(tools, llm,
agent=AgentType.STRUCTURED_CHAT_ZERO_SHOT_REACT_DESCRIPTION,
verbose=True)
agent.run("Price a $3M EUR→USD settlement and verify the oracle is stable.")
05 n8n — No-Code Treasury Workflows
Best for
Treasury operations teams who want automated settlement workflows — schedule-triggered, alert-triggered, or approval-gated — without writing code.
DPX integrates with n8n via HTTP Request nodes pointing at the REST API. Typical treasury automation workflows:
The Full Agentic Treasury Loop
A complete AI-driven settlement cycle using DPX. All steps except Execute are available today with no authentication.
Check Stability
GET /reliability
Confirm oracle is at TIER 1 or 2 before proceeding. If unstable, abort and notify.
Score ESG
GET /esg-score?entity={counterparty}
Pull the counterparty's ESG score. Higher score = lower DPX fee. Log for audit trail.
Get Quote
GET /quote?amountUsd={n}&hasFx=true&esgScore={s}
Receive full fee breakdown + quoteId. Valid 300 seconds. Use sandbox=true first.
Verify Fees
GET /verify-fees?quoteId={id}
Confirm on-chain fees match quote. This is the mandatory pre-execution gate.
Execute Settlement
POST /settle
On-chain settlement via DPXSettlementRouter on Base mainnet. Beta access required. Request access →
Getting Started
Available Now — No Signup
- All read endpoints (
/reliability,/esg-score,/quote,/verify-fees) - All agent discovery files (
/llms.txt,/openapi.json,/.well-known/ai-plugin.json) - Sandbox mode (
?sandbox=true) — real fee calculations, no execution - MCP server for Claude Desktop
- GPT Actions schema
- LangChain tools
- n8n integration
Beta Access Required
- On-chain settlement execution (
POST /settle) - Whitelisted settlement wallet setup
- Volume discount tier assignment
- ESG redistribution receipts
Email: beta@untitledfinancial.com
Response time: 1–2 business days