XRPLME Country Intelligence

XRPLME Country Intelligence — MCP サーバー

x402 を利用し、呼び出しごとに XRP または USDC で決済して、30 か国の出典付き経済・政策データを MCP 経由で提供します。

アカウントも 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 を呼び出して、対象国を確認します。無料です。

---

ツール

8 つのツールを提供しています。6 つは無料で、2 つは有料です。

ツール	内容	料金
xrplme_list_countries	30 か国を一覧表示します	無料
xrplme_get_country_status	1 か国の稼働状況をリアルタイムで確認します	無料
xrplme_get_pricing	2 つの決済手段の現在の料金を返します	無料
xrplme_get_country_data	1 か国の最新の構造化データ、出典、鮮度を返します	有料
xrplme_get_country_schema	1 か国のフィールドスキーマ（JSON Schema）を返します	有料
xrplme_get_survey_questions	AI エージェント向けのアンケート質問を返します	無料
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. 次の 3 つの決済手段のいずれかで支払います。
   • XRP Ledger — X-PAYMENT-SIGNATURE と X-INV-ID ヘッダーを渡します
   • Solana — 署名済み Solana トランザクションを含む、Base64 エンコードされた V2 決済ペイロードを X-PAYMENT-SIGNATURE ヘッダーで渡します
   • クレジットカード — https://api.xrplme.online/api/v1/card/start の Crossmint オンランプ URL を開き、ブラウザーでカードを使って XRP を購入してから、x402 インボイスを支払います。暗号資産ウォレットは不要です。
3. 決済情報を添えて、もう一度ツールを呼び出します。決済が正常に完了すると、データが返されます。

決済はオンチェーンで検証され、1 回限り有効です。再利用された署名は拒否されます。データは決済の確定後にのみ返され、確定前に返されることはありません。

ネットワーク

決済手段	ネットワーク
XRP Ledger	xrpl:0（メインネット）
Solana	solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp（メインネット）

Solana での決済には、ネイティブ USDC（EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v）を使用します。

Solana 決済の詳細

Solana 決済では、ローカルファシリテーター（http://127.0.0.1:8402）を介して、x402 の exact 決済スキームを使用します。402 レスポンスの extra フィールドには feePayer が含まれます。これは Solana トランザクション手数料を支払うウォレットです。クライアントは次の手順を実行する必要があります。

1. 3 つの命令（SetComputeUnitLimit、SetComputeUnitPrice、TransferChecked（USDC、小数点以下 6 桁））を含むトランザクションを作成します
2. 402 レスポンスの feePayer を、トランザクションの手数料支払い元として設定します
3. USDC を保有するウォレットでトランザクションに部分署名します。fee payer では署名しないでください。ファシリテーターが署名を追加します
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 が正式な一覧です。

---

レスポンススキーマ

すべての有料レスポンスは、https://xrplme.online/schema/v1/response-schema.json に記載されている構造化された v1 スキーマに従います。

主なフィールド：

• meta — 国のスラッグ、クエリ ID、取得日時、データの鮮度、支払い証明
• sources[] — URL、発行元、日付、信頼度スコアを含む一次ソースの配列
• facts — ドメイン別（company_formation、labor、tax など）の決定論的な構造化データ
• synthesis — AI による要約、主なリスク、見つかった矛盾、全体的な信頼度
• agent_hints — 推奨される後続ツール、関連国、更新頻度

この構造により、エージェントは文章を再解析せずに呼び出しを連鎖できます。