Integrate AI agents with 90-country economic data via x402 micropayments on the XRP Ledger or Solana USDC.
# Standard — 1 XRP (XRPL) POST https://xrplme.online/wc/v1/{country}/bot Content-Type: application/json {"message": "Tourism numbers for Thailand Q2 2025", "session_id": "demo-001"} # Standard — 1 USDC (Solana) POST https://xrplme.online/wc/v1/{country}/bot-solana Content-Type: application/json {"message": "Tourism numbers for Thailand Q2 2025", "session_id": "demo-001"}
HTTP/1.1 402 Payment Required X-INV-ID: <invoice_hash> X-PAYMENT-ADDRESS: r...<pay_to_address> X-AMOUNT: 1000000 (drops, = 1 XRP) X-DEST-TAG: <dest_tag>
HTTP/1.1 402 Payment Required
Content-Type: application/json
{
"accepts": [
{
"payTo": "5KMiN7...",
"amount": 1000000,
"asset": "EPjFW...",
"network": "solana"
}
]
}
payTo, amount (raw, 6 decimals = 1 USDC), and qrData (Solana Pay URI). See the Solana payment example for the full flow.Pay in XRP via Xaman or Joey wallet, or sign programmatically with the xrpl SDK. Pay in USDC via any Solana Pay wallet (Xaman, Phantom, Solflare). Retry your original request with the payment signature header. No API keys needed.
# After paying, retry the same POST with: X-PAYMENT-SIGNATURE: <tx_hash> # XRPL: signed transaction hash X-INVOICE-ID: <invoice_hash> # matches the 402 invoiceId # For Solana USDC, use the x_sol_payload header instead: x_sol_payload: <base64_payment_payload>
Same country data, same three tiers, same request body and response shape as the XRPL and Solana routes, payable in USDC on Base.
POST https://xrplme.online/wc/v1/{country}/bot-evm $1.00 USDC
POST https://xrplme.online/wc/v1/{country}/bot-evm/ai $7.00 USDC
POST https://xrplme.online/wc/v1/{country}/bot-evm/custom $15.00 USDC
HTTP/1.1 402 Payment Required
{
"x402Version": 2,
"resource": { "url": "https://xrplme.online/wc/v1/thailand/bot-evm", ... },
"accepts": [{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "1000000",
"payTo": "0xa9FA5f8b14A8f683Ca634f34f0d3f5688417438c",
"maxTimeoutSeconds": 600,
"extra": { "settlement": "onchain-transfer", "decimals": 6 }
}]
}
payTo address above.curl -X POST https://xrplme.online/wc/v1/thailand/bot-evm \
-H "Content-Type: application/json" \
-H 'PAYMENT-SIGNATURE: {"txHash":"0x..."}' \
-d '{"message":"recent policy changes"}'
A 200 returns the records. One transfer buys one call: a reused hash returns 409, a transfer below the tier price or older than one hour is rejected with 402, and a payment made on another chain or sent to another address is not accepted. The transfer is verified directly against Base, so nothing sits between your payment and the data.
A Base Sepolia twin runs the identical verification so you can rehearse without real money:
POST /wc/v1/{country}/bot-evm-test[/ai|/custom] on eip155:84532, same
prices in test USDC. It verifies the payment and returns a receipt, and does not serve records —
paid data is only served on the production rails.
11 tools. Six are free (discovery, health, pricing, survey); five are paid per query over x402. Paid tools take the payment headers shown in the examples below.
| Tool | What it returns | Access | Price |
|---|---|---|---|
xrplme_list_countries | List all 90 countries with slug, name, live status | Free | — |
xrplme_get_country_status | Live health probe: record count and last-refresh date | Free | — |
xrplme_get_pricing | Pricing on all three rails | Free | — |
xrplme_get_country_data | Source-backed economic, policy and regulatory data | Paid | 1 XRP or $1.00 USDC |
xrplme_get_country_schema | Structured record plus freshness | Paid | 1 XRP or $1.00 USDC |
xrplme_screen | Sanctions / screening check for a person or company | Paid | $2.00 USDC |
xrplme_entity_lookup | Company look-up and permanent entity ID | Paid | $1.00 USDC |
xrplme_entity_ownership | Ownership chain to the ultimate parent | Paid | $5.00 USDC |
xrplme_get_survey_questions | Survey questions for agents | Free | — |
xrplme_submit_survey | Submit agent feedback | Free | — |
xrplme_get_survey_stats | Aggregated survey statistics | Free | — |
# 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" }
}
}
# 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);
| Endpoint | Cost (XRPL) | Cost (Solana) | Description |
|---|---|---|---|
GET /wc/v1/{country}/health | FREE | FREE | Check country availability |
POST /wc/v1/{country}/bot | 1 XRP | 1 USDC | Standard tier — factual data |
POST /wc/v1/{country}/bot/ai | 5 XRP | 7 USDC | AI-enhanced analysis (deep synthesis) |
POST /wc/v1/{country}/bot-solana | 1 XRP | 1 USDC | Factual data (Solana USDC) |
POST /wc/v1/{country}/bot-solana/ai | 5 XRP | 7 USDC | AI-enhanced analysis (Solana USDC) |
POST /mcp | x402 / tool | x402 / tool | MCP protocol (AI agents) |
All 90 countries are listed with their exact endpoints and prices on the countries page. Slugs are long names: thailand, hong_kong, papua-new-guinea.
The rails accept XRP on the XRP Ledger or USDC on Solana. If you hold neither, buy USDC with a debit or credit card at Crossmint — Apple Pay and Google Pay work — with your own Solana wallet as the destination, then pay the endpoint from that wallet.
Three things worth knowing:
All 90 countries, endpoints and prices are listed on the countries page.
All paid API responses (REST + MCP) follow the v1 JSON schema at schema/v1/response-schema.json. Key fields:
meta — country_slug, query_id, retrieved_at, schema_version, payment (rail + TXID + amount + invoice_id), data_freshnesssources[] — primary source URLs with publisher, published date, confidence score (0.0-1.0)facts — structured by domain (company_formation, labor, tax, crypto_regulation, trade)synthesis — summary, key_risks, comparison_hooks, confidence_overall, contradictions_foundagent_hints — recommended_followup_tools, related_countries, update_frequency_daysExample after successful payment:
{
"meta": {
"country_slug": "thailand",
"query_id": "q_thailand_...",
"retrieved_at": "2026-10-23T12:00:00Z",
"payment": {"rail": "xrpl", "txid": "E5A...", "amount": "1 XRP", "invoice_id": "..."},
"schema_version": "1.0.0"
},
"sources": [...],
"facts": {...},
"synthesis": {...},
"agent_hints": {...}
}
Two more datasets on the same rails. Check a person or company against official watchlists before you deal with them. Look up a company and walk its ownership to the ultimate parent. Pay per call in XRP or USDC, no signup, no key.