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
| 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