xrplme.online MCP Server
O xrplme.online fornece a agentes de IA dados econômicos e regulatórios com fonte verificada para 30 países, pagos por consulta em XRP através do protocolo de micropagamentos x402 no XRP Ledger. Seu servidor MCP expõe ferramentas para listar países, verificar o status de um país, ler preços e executar pesquisas regionais — sem chaves de API e sem contas: os agentes leem o manifesto público e pagam por chamada.
Documentação
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": "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 | 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