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
| Endpoint | Cost | Description |
|---|---|---|
GET /wc/v1/{country}/health | FREE | Check country availability |
POST /wc/v1/{country}/bot | 1 XRP | Factual data |
POST /wc/v1/{country}/bot | 1 XRP | Country Brief data lookup |
POST /wc/v1/{country}/bot/ai | 5 XRP | Deep Concierge AI analysis |
POST /wc/v1/{country}/bot/custom | 15 XRP | Custom Bounded deep research |
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