XRPLME Country Intelligence

XRPLME 国家情报 — MCP 服务

通过 MCP 提供 30 个国家有来源支持的经济和政策数据，并使用 x402 按次付费——以 XRP 或 USDC 结算。

无需账号，也无需 API 密钥。付款本身就是身份验证。

线上端点： https://api.xrplme.online/mcp — Streamable HTTP 传输。

本仓库的内容。 本仓库介绍托管服务：端点、工具、价格以及连接方式。服务的实现本身不开源，也未在此发布。使用该端点不需要本仓库中的任何内容——你只需要 URL。

---

连接

将服务添加到任何支持 Streamable HTTP 的 MCP 客户端：

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

然后调用 xrplme_list_countries 查看覆盖范围。此操作免费。

---

工具

共提供八个工具。其中六个免费，两个需要付费。

工具	功能	费用
xrplme_list_countries	列出 30 个国家	免费
xrplme_get_country_status	实时检查单个国家的状态	免费
xrplme_get_pricing	查看两种支付渠道的当前价格	免费
xrplme_get_country_data	获取单个国家的最新结构化数据、来源和时效信息	付费
xrplme_get_country_schema	获取单个国家的字段架构（JSON Schema）	付费
xrplme_get_survey_questions	获取面向 AI Agent 的问卷问题	免费
xrplme_submit_survey	提交反馈	免费
xrplme_get_survey_stats	获取汇总问卷统计数据	免费

价格

级别	XRP Ledger	Solana	信用卡（入金）
标准版（xrplme_get_country_schema）	1 XRP	1.0 USDC	$2
AI 增强版（xrplme_get_country_data）	5 XRP	7.0 USDC	$25

xrplme_get_pricing 始终返回实时价格——请查询该工具，而不要将这些价格硬编码。

---

付款方式

1. 不附带付款信息，调用一个付费工具。服务会返回 HTTP 402，其中包含确切金额、资产、收款方和可接受的网络。不会扣款，也不会返回数据。
2. 通过以下三种渠道之一付款：
   • XRP Ledger — 传入 X-PAYMENT-SIGNATURE + X-INV-ID 标头
   • Solana — 传入 X-PAYMENT-SIGNATURE 标头，值为包含已签名 Solana 交易的 base64 编码 V2 付款载荷
   • 信用卡 — 打开 https://api.xrplme.online/api/v1/card/start 中的 Crossmint 入金链接，在浏览器中使用信用卡购买 XRP，然后支付 x402 发票。无需加密货币钱包。
3. 再次调用该工具并附上付款信息。结算成功后，服务会返回数据。

付款会在链上验证，且只能使用一次——重复使用的签名会被拒绝。只有在确认结算后才会释放数据，绝不会提前释放。

网络

支付渠道	网络
XRP Ledger	xrpl:0（主网）
Solana	solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp（主网）

Solana 付款使用原生 USDC （EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v）。

Solana 付款详情

Solana 付款通过本地 facilitator（http://127.0.0.1:8402）使用 x402 精确付款方案。402 响应的 extra 字段中包含 feePayer——这是支付 Solana 交易费用的钱包。你的客户端必须：

1. 构建包含 3 条指令的交易：SetComputeUnitLimit、 SetComputeUnitPrice 和 TransferChecked（USDC，6 位小数）
2. 将 402 响应中的 feePayer 设为交易费用支付方
3. 使用持有 USDC 的钱包对交易进行部分签名—— 不要使用费用支付方签名；facilitator 会添加其签名
4. 将部分签名后的交易编码为 base64，并将其包含在 V2 付款载荷中：

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

5. 将整个载荷 JSON 编码为 base64，并在重试请求中将其作为 X-PAYMENT-SIGNATURE 标头发送。

完整的端到端示例请参见 xrplme-mcp-client/examples/x402_payment_solana.py。

---

注册表

已列入官方 MCP 注册表，条目为 io.github.DaimyoVegan/xrplme-paid。

---

相关内容

• xrplme-mcp-client — 客户端示例和可用的支付流程。
• 网站 / API 文档： https://xrplme.online/api-docs.html

---

说明

• 数据来自国家统计局、中央银行和监管机构。每个响应都包含自身的新鲜度元数据；依赖某项数据前请先检查。
• 覆盖 30 个国家。xrplme_list_countries 是权威列表。

---

响应架构

每个付费响应都遵循有文档说明的结构化 v1 架构，详见 https://xrplme.online/schema/v1/response-schema.json。

关键字段：

• meta — 国家别名、查询 ID、检索时间戳、数据新鲜度、支付凭证
• sources[] — 主要来源数组，包含 URL、发布方、日期和置信度评分
• facts — 按领域划分的确定性结构化数据（company_formation、labor、tax 等）
• synthesis — AI 摘要、主要风险、发现的矛盾、总体置信度
• agent_hints — 建议的后续工具、相关国家、更新频率

这种结构让 Agent 能够串联调用，而无需重新解析散文文本。