xrplme.online MCP Server

xrplme.online gives AI agents source-backed economic and regulatory data for 30 countries, paid per query in XRP over the x402 micropayment protocol on the XRP Ledger. Its MCP server exposes tools to list countries, check country status, read pricing, and run regional research — no API keys and no accounts: agents read the public manifest and pay per call.

Documentation

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

EndpointCostDescription
GET /wc/v1/{country}/healthFREECheck country availability
POST /wc/v1/{country}/bot0.1 XRPFactual data
POST /wc/v1/{country}/bot/ai0.5 XRPAI-enhanced analysis
POST /mcpx402 / toolMCP 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