BlinkCodes エージェントインターフェース

blinkcodes.com 向けの機械可読インターフェース — ギフトカードコード、サービスチャージ、旅行用eSIMを販売し、メールで数秒以内に配信するストアです。

ここにあるものはすべてリモートのホスト型サービスです。インストールするものも、実行するサーバーもありません。クライアントを以下のURLに向けるだけです。このリポジトリは、それらのエンドポイントを文書化し、スキーマを固定し、動作例を提供するために存在します。

ディスカバリードキュメント: /.well-known/agent-card.json、 /.well-known/mcp/server-card.json、 /.well-known/api-catalog、 /.well-known/agent-skills/index.json、 /.well-known/acp.json、 /.well-known/ucp。

MCPサーバー

公式MCPレジストリに**com.blinkcodes/catalog**として公開されています（server.json）。

3つのツールがあります。カタログ用の2つのツールは読み取り専用で無料です — キーもアカウントも支払いも不要です。3つ目は課金が発生し、x402経由でのみ利用できます:

buy_product は以下の POST /api/v1/buy と同じ経路で動作します — 検証、予約、決済、履行の順序です — そのため、MCPを通じてストアを見つけたエージェントは、購入を完了するためにプロトコルを変更する必要がありません。最初の呼び出しで課金されることはなく、他の2つのツールを使用するのにウォレットも不要です。

リモートMCPに対応したクライアントに追加します:

{
  "mcpServers": {
    "blinkcodes": {
      "type": "http",
      "url": "https://blinkcodes.com/mcp"
    }
  }
}

完全なツールスキーマとcurlのトランスクリプト: docs/mcp.md。

stdioのみのクライアントは、Dockerfile のブリッジを使用できます。これは同じホスト型エンドポイントにプロキシします:

docker build -t blinkcodes-mcp . && docker run -i --rm blinkcodes-mcp

クライアントがリモートMCPに対応している場合は、上記の直接URLを優先してください — ブリッジはホップを追加するだけで、何も購入しません。

Related MCP server: the402-mcp-server

エージェント向け購入

支払いはx402経由のBase上のUSDCです。1つのエンドポイント、2回のパス:

1. 注文ボディを指定して POST /api/v1/buy → その正確な商品に対して価格設定された支払い要件と、order ブロック（id、アクセストークン、ステータスURL）を伴う402。

2. PAYMENT-SIGNATURE ヘッダーを付けた同一のリクエスト → コード付きの200、または履行が同期ウィンドウを超える場合は202＋status_url。

// the body, in both passes
{
  "email": "buyer@example.com",
  "product_type": "giftcard",   // giftcard | topup | esim | phone_rental
  "product_id": 187,
  "item_id": 1195,
  "quantity": 1
}

• ネットワーク eip155:8453、アセット 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913（USDC）。

• x402はデフォルトでv2。v1クライアントは X-PAYMENT を送信するか、X-PAYMENT-VERSION: 1 でv1の見積もりを要求します。

• GET /api/v1 は経路を無料で説明します。

• 何も指定せずに /api/v1/buy を呼び出すと、経路の下限価格を提示する402が返り、注文は作成されません — これはプローブ形式であり、クローラーにとって安全です。

動作例: examples/x402-buy.mjs。経路、下限価格、支払い可能なコインペア: GET /api/public/payment-methods。

A2A

エージェントカードは /.well-known/agent-card.json、 JSON-RPC message/send は https://blinkcodes.com/a2a にあります。スキルは2つのカタログツールに加えて buy_product で、このトランスポートでは a2a-x402 支払い拡張機能 （https://github.com/google-a2a/a2a-x402/v0.1、カタログスキルは無料のため required: false と宣言）を運びます。

見積もり → x402.payment.required を持つ input-required 状態の Task。支払い → 同じ taskId に x402.payment.payload を指定 → completed 状態の Task と、成果物としての配信内容。 examples/a2a.sh を参照してください。

人向けドキュメント

ストア、価格、利用規約: https://blinkcodes.com。サポート: support@blinkcodes.com。

ライセンス

MIT — このリポジトリのドキュメントと例に適用されます。 サービス自体は、サイトに公開されている規約に準拠します。