Home API Agents Research

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

~/Library/Application Support/Claude/claude_desktop_config.json json
{
  "mcpServers": {
    "dpx": {
      "command": "node",
      "args": ["/path/to/dpx-mcp-server/index.js"],
      "env": {}
    }
  }
}

Available MCP Tools

ToolDescription
get_manifestProtocol capabilities, contract addresses, supported currencies
get_quoteFull fee breakdown — core, FX, ESG, license — with quoteId
get_esg_scoreLive E, S, G scores from 6 institutional sources
get_reliabilityStability signals, peg deviation, oracle consensus
get_fee_scheduleComplete fee table for all settlement tiers
verify_feesConfirm on-chain fees match the quote before execution
get_oracle_statusRaw oracle output from all 14 data sources
compare_to_competitorsDPX vs. Stripe, Wise, SWIFT for a given transaction

Example Prompts for Claude

Price a $5M cross-border EUR→USD settlement at current ESG score
Check oracle stability before a large payment
Get a quoteId for $2M, then verify the fees
Compare DPX fees to SWIFT for $10M
What is the ESG score for [entity]?

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.

Fetch schema + call directly bash
# 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:

FileStandardPurpose
/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:

Schema URL to paste into GPT Actions url
https://dpx-docs.pages.dev/openapi.json

Recommended GPT System Prompt

Paste this as the GPT's Instructions text
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.

LangChain DPX tools — Python python
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:

⏰ Scheduled
Check stability If stable: get quote Verify fees Execute (beta)
🔔 Alert
Stability drops Pause queue Notify Slack Resume when stable
📋 Approval
Request comes in Price quote Human approves Execute settlement

🔄 The Full Agentic Treasury Loop

A complete AI-driven settlement cycle using DPX. All steps except Execute are available today with no authentication.

1

Check Stability

GET /reliability

Confirm oracle is at TIER 1 or 2 before proceeding. If unstable, abort and notify.

2

Score ESG

GET /esg-score?entity={counterparty}

Pull the counterparty's ESG score. Higher score = lower DPX fee. Log for audit trail.

3

Get Quote

GET /quote?amountUsd={n}&hasFx=true&esgScore={s}

Receive full fee breakdown + quoteId. Valid 300 seconds. Use sandbox=true first.

4

Verify Fees

GET /verify-fees?quoteId={id}

Confirm on-chain fees match quote. This is the mandatory pre-execution gate.

5

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
Request Beta Access →

Email: beta@untitledfinancial.com
Response time: 1–2 business days