xrplme.online MCP Server

xrplme.online fournit aux agents IA des données économiques et réglementaires sourcées pour 30 pays, payées par requête en XRP via le protocole de micropaiement x402 sur le XRP Ledger. Son serveur MCP expose des outils pour lister les pays, vérifier leur statut, consulter les tarifs et effectuer des recherches régionales — sans clés API ni comptes : les agents lisent le manifeste public et paient par appel.

Voir sur xrplme.online

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

EndpointCostDescription
GET /wc/v1/{country}/healthFREECheck country availability
POST /wc/v1/{country}/bot1 XRPFactual data
POST /wc/v1/{country}/bot1 XRPCountry Brief data lookup
POST /wc/v1/{country}/bot/ai5 XRPDeep Concierge AI analysis
POST /wc/v1/{country}/bot/custom15 XRPCustom Bounded deep research
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