xrplme.online MCP Server

xrplme.online cung cấp cho các tác nhân AI dữ liệu kinh tế và quy định có nguồn gốc rõ ràng cho 30 quốc gia, thanh toán theo từng truy vấn bằng XRP qua giao thức thanh toán vi mô x402 trên XRP Ledger. Máy chủ MCP của nó cung cấp các công cụ để liệt kê quốc gia, kiểm tra trạng thái quốc gia, đọc giá và chạy nghiên cứu khu vực — không cần khóa API và không cần tài khoản: các tác nhân đọc bảng kê khai công khai và trả phí cho mỗi lần gọi.

Xem trên xrplme.online

Tài liệu

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