Xrplme MCP Server

XRPLME Country Intelligence — MCP Server

Source-backed economic and policy data for 30 countries, served over MCP and paid per call with x402 — settled in XRP or USDC.

No accounts, no API keys. The payment is the authentication.

Live endpoint: https://api.xrplme.online/mcp — Streamable HTTP transport.

What this repository is. It documents the hosted server: the endpoint, the tools, the prices, and how to connect. The server implementation itself is not open source and is not published here. Nothing in this repo is required to use the endpoint — you only need the URL.

---

Connect

Add the server to any MCP client that supports Streamable HTTP:

{
  "mcpServers": {
    "xrplme": {
      "type": "http",
      "url": "https://api.xrplme.online/mcp"
    }
  }
}

Then call xrplme_list_countries to see the coverage. It is free.

---

Tools

Eight tools are exposed. Six are free; two require payment.

Prices

xrplme_get_pricing always returns the live values — query it rather than hard-coding these.

---

How payment works

1. Call a paid tool with no payment. The server replies HTTP 402 with the exact amount, asset, recipient, and accepted networks. Nothing is charged and no data is returned.
2. Pay on any of three rails:
   • XRP Ledger — pass X-PAYMENT-SIGNATURE + X-INV-ID headers
   • Solana — pass X-PAYMENT-SIGNATURE header with a base64-encoded V2 payment payload containing the signed Solana transaction
   • Credit card — open the Crossmint on-ramp URL from https://api.xrplme.online/api/v1/card/start, buy XRP with a card in your browser, then pay the x402 invoice. No crypto wallet required.
3. Call the tool again with the payment attached. On successful settlement the data is returned.

Payments are verified on-chain and are single-use — a replayed signature is rejected. Data is released only after settlement is confirmed, never before.

Networks

Solana payments use native USDC (EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v).

Solana payment details

Solana pays use the x402 exact payment scheme via a local facilitator (http://127.0.0.1:8402). The 402 response includes a feePayer in the extra field — this is the wallet that pays Solana transaction fees. Your client must:

1. Build a transaction with 3 instructions: SetComputeUnitLimit, SetComputeUnitPrice, and TransferChecked (USDC, 6 decimals)
2. Set the feePayer from the 402 response as the transaction fee payer
3. Partially sign the transaction with your wallet (which holds the USDC) — do not sign with the fee payer; the facilitator adds its signature
4. Encode the partially-signed transaction as base64 and include it in a V2 payment payload:

{
  "x402Version": 2,
  "payload": {"transaction": "<base64-encoded signed tx>"},
  "accepted": { /* from the 402 response's accepts[0] */ }
}

1. Base64-encode the entire payload JSON and send it as the X-PAYMENT-SIGNATURE header on the retry request.

See xrplme-mcp-client/examples/x402_payment_solana.py for a complete end-to-end example.

---

Registry

Listed in the official MCP Registry as io.github.DaimyoVegan/xrplme-paid.

---

Related

• xrplme-mcp-client — client examples and working payment flows.
• Website / API docs: https://xrplme.online/api-docs.html

---

Notes

• Data is sourced from national statistics offices, central banks, and regulators. Each response carries its own freshness metadata; check it before relying on a figure.
• Coverage is 30 countries. xrplme_list_countries is the authoritative list.

---

Response Schema

Every paid response follows a structured v1 schema documented at https://xrplme.online/schema/v1/response-schema.json.

Key fields:

• meta — country slug, query ID, retrieval timestamp, data freshness, payment proof
• sources[] — array of primary sources with URL, publisher, date, and confidence score
• facts — deterministic structured data by domain (company_formation, labor, tax, etc.)
• synthesis — AI summary, key risks, contradictions found, overall confidence
• agent_hints — recommended follow-up tools, related countries, update frequency

This structure lets agents chain calls without re-parsing prose.