Developers

Integrate AI agents with 30-country economic data via x402 micropayments on the XRP Ledger.

Quick Start

1. Send a request

# Standard endpoint — 0.1 XRP
POST https://xrplme.online/wc/v1/{country}/bot
Content-Type: application/json

{"message": "Tourism numbers for Thailand Q2 2025", "session_id": "demo-001"}

2. Receive 402 Payment Required

HTTP/1.1 402 Payment Required
X-INV-ID:          <invoice_hash>
X-PAYMENT-ADDRESS: r...<pay_to_address>
X-AMOUNT:          100000  (drops, = 0.1 XRP)
X-DEST-TAG:        <dest_tag>

Note: No API keys needed. The 402 response itself contains all payment instructions.

3. Pay & retry

Submit the XRP payment via Xaman or Joey wallet, or sign programmatically with the xrpl SDK. Retry your original request with the invoice header.

MCP Integration (AI Agents)

# Initialize MCP session
POST https://api.xrplme.online/mcp
Content-Type: application/json
Accept: application/json, text/event-stream

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {},
    "clientInfo": { "name": "agent", "version": "1.0" }
  }
}

Endpoints

Endpoint	Cost	Description
`GET /wc/v1/{country}/health`	FREE	Check country availability
`POST /wc/v1/{country}/bot`	0.1 XRP	Factual data
`POST /wc/v1/{country}/bot/ai`	0.5 XRP	AI-enhanced analysis
`POST /mcp`	x402 / tool	MCP protocol (AI agents)

Countries (30)

thailand · vietnam · japan · korea · usa · canada · uae · uk · philippines · singapore · australia · germany · france · brazil · mexico · switzerland · netherlands · hong_kong · india · malaysia · indonesia · taiwan · macau · newzealand · brunei · laos · myanmar · timor-leste · papua-new-guinea · italy

SDKs & Examples

Python, Node, LangChain, LlamaIndex
MCP client (this repo)
xrpl.js / xrpl-py