xrplme.online MCP Server
xrplme.online menyediakan data ekonomi dan regulasi berbasis sumber untuk agen AI di 30 negara, dibayar per kueri dalam XRP melalui protokol pembayaran mikro x402 di XRP Ledger. Server MCP-nya mengekspos alat untuk mencantumkan negara, memeriksa status negara, membaca harga, dan menjalankan riset regional — tanpa kunci API dan tanpa akun: agen membaca manifes publik dan membayar per panggilan.
Dokumentasi
Developers
Integrate AI agents with 30-country economic data via x402 micropayments on the XRP Ledger.
Quick Start
1. Send a request
# Standard endpoint — 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, = 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": "2025-06-18",
"capabilities": {},
"clientInfo": { "name": "agent", "version": "1.0" }
}
}
Copy-paste client config
# Python (mcp SDK)
from mcp import ClientSession, StdioServerParameters
from mcp.client.streamable_http import streamablehttp_client
async with streamablehttp_client("https://api.xrplme.online/mcp") as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
result = await session.call_tool("xrplme_list_countries", {})
print(result)
# Node.js (@modelcontextprotocol/sdk)
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const transport = new StreamableHTTPClientTransport(
new URL("https://api.xrplme.online/mcp")
);
const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(transport);
const result = await client.callTool({ name: "xrplme_list_countries", arguments: {} });
console.log(result);
Endpoints
| Endpoint | Cost | Description |
|---|---|---|
GET /wc/v1/{country}/health | FREE | Check country availability |
POST /wc/v1/{country}/bot | 1 XRP | Factual data |
POST /wc/v1/{country}/bot | 1 XRP | Country Brief data lookup |
POST /wc/v1/{country}/bot/ai | 5 XRP | Deep Concierge AI analysis |
POST /wc/v1/{country}/bot/custom | 15 XRP | Custom Bounded deep research |
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