xrplme.online MCP Server

xrplme.online은 30개국의 출처 기반 경제 및 규제 데이터를 AI 에이전트에 제공하며, XRP Ledger의 x402 마이크로페이먼트 프로토콜을 통해 쿼리당 XRP로 결제됩니다. 해당 MCP 서버는 국가 목록 조회, 국가 상태 확인, 가격 확인, 지역 리서치 실행 도구를 제공하며, API 키나 계정이 필요 없습니다. 에이전트는 공개 매니페스트를 읽고 호출당 결제합니다.

문서

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