giftcardshop

@giftcardshop/mcp

AI エージェントが giftcardshop のカタログを閲覧し、Lightning でギフトカードを購入できる MCP サーバーです。アカウントも登録も不要です。エージェントが Lightning インボイスを支払うと、コードが表示される一度だけ閲覧可能なリンクを受け取ります。

読み取りツールはキーなしで稼働中の公開 API を利用します。create_order は早期アクセス機能です。共有の GCS_INTERNAL_SECRET が必要です（https://giftcardshop.org/contact から申請してください）。この設定がなくても読み取りツールは引き続き利用できますが、create_order は設定されていないことを通知します。

ツール

ツール	種類	接続先
list_brands	読み取り	GET /v1/brands
search_products	読み取り	GET /v1/products
get_product	読み取り	GET /v1/products/:id（バリエーション＋額面）
get_order_status	読み取り	GET /v1/orders/:id（支払い状況＋コード表示の可否）
create_order	書き込み	POST /internal/agent-orders（HMAC） -> Lightning インボイス

読み取りツールは API の JSON をそのまま渡します。create_order は { orderId, invoiceId, invoiceUrl, bolt11?, sats?, total, currency, expiresAt } を返します。

実行

# read-only (browsing works, create_order reports "not configured")
npx @giftcardshop/mcp

# with checkout enabled
GCS_INTERNAL_SECRET=<64-hex> npx @giftcardshop/mcp

Claude Desktop／任意の MCP クライアント（stdio）：

{
  "mcpServers": {
    "giftcardshop": {
      "command": "npx",
      "args": ["-y", "@giftcardshop/mcp"],
      "env": { "GCS_INTERNAL_SECRET": "<64-hex>" }
    }
  }
}

設定

環境変数	デフォルト	用途
GCS_API_BASE	https://api.giftcardshop.org	公開 API のベース URL
GCS_INTERNAL_SECRET	（未設定）	64 桁の 16 進数 HMAC シークレット。create_order を有効にします。未設定の場合は読み取り専用です。

チェックアウト（create_order）

create_order は POST /internal/agent-orders にリクエストを送信し、GCS_INTERNAL_SECRET で HMAC 署名します（ヘッダーは x-internal-sig）。その後、Lightning インボイスを返します。支払い後、get_order_status をポーリングして、一度だけ閲覧可能な表示リンクを取得します。Nostr ID もパートナーアカウントも不要です。

ロードマップ

• L402（Lightning HTTP 402）により、人手を介さずエージェントが呼び出しごとに支払えるようにします。
• インストール不要の、ホスト型 HTTP 経由リモート MCP。
• モバイルへのチャージに対応する btcrecharge MCP（同じ形式）。