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

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