Giftcardshop

org.giftcardshop由 giftcardshop.org 发布v0.1.1更新于 Oct 24, 2026

Browse the giftcardshop catalog and buy gift cards with Lightning over MCP. No account, no signup.

已验证STDIO仅桌面金融商业与电商

概览

AI 生成的概览

让助手浏览礼品卡目录，并在持有共享密钥时创建闪电网络支付的订单并获取兑换链接。

可以做什么
它提供读取工具，查询 giftcardshop 的公开实时 API：list_brands、search_products、get_product（含规格与面额）以及用于查询支付状态和兑换可用性的 get_order_status。写入工具 create_order 会发送带 HMAC 签名的请求，返回包含订单号、金额、币种和有效期的闪电网络发票。读取工具原样透传 API 返回的 JSON。
适用场景
当你希望助手查询礼品卡品牌、商品和面额，或无需注册账号即可用比特币闪电网络下单并跟踪礼品卡订单时使用。
运行要求
通过 stdio 在本地运行，通常用 npx 执行 npm 包 @giftcardshop/mcp，因此需要 Node.js。浏览工具只需访问公开 API 的网络连接，可用 GCS_API_BASE 覆盖默认地址。结账功能需要环境变量 GCS_INTERNAL_SECRET，即向提供方申请的 64 位十六进制 HMAC 密钥。
安装前请注意
create_order 是写入操作，会创建真实订单和闪电网络发票，支付即产生实际花费；需支付发票并轮询订单以获取仅可查看一次的兑换链接。GCS_INTERNAL_SECRET 是授权创建订单的共享密钥，以 HMAC 签名请求头发送，请勿写入日志或共享配置。读取工具会将目录和订单查询发送给提供方的 API。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Giftcardshop，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@giftcardshop/mcp

MCP server that lets AI agents browse the giftcardshop catalog and buy gift cards with Lightning - no account, no signup. The agent pays a Lightning invoice and receives a single-view reveal link with the code.

Read tools work against the live public API with no key. create_order is early access: it needs the shared GCS_INTERNAL_SECRET (request one at https://giftcardshop.org/contact); without it the read tools still work and create_order reports that it is not configured.

Tools

ToolKindBacked by
list_brandsreadGET /v1/brands
search_productsreadGET /v1/products
get_productreadGET /v1/products/:id (variants + denominations)
get_order_statusreadGET /v1/orders/:id (payment state + reveal availability)
create_orderwritePOST /internal/agent-orders (HMAC) -> Lightning invoice

Read tools pass the API JSON through verbatim. create_order returns { orderId, invoiceId, invoiceUrl, bolt11?, sats?, total, currency, expiresAt }.

Run

bash
# read-only (browsing works, create_order reports "not configured")npx @giftcardshop/mcp
# with checkout enabledGCS_INTERNAL_SECRET=<64-hex> npx @giftcardshop/mcp

Claude Desktop / any MCP client (stdio):

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

Config

EnvDefaultPurpose
GCS_API_BASEhttps://api.giftcardshop.orgpublic API base
GCS_INTERNAL_SECRET(unset)64-hex HMAC secret; enables create_order. Unset = read-only.

Checkout (create_order)

create_order POSTs to POST /internal/agent-orders, HMAC-signed with GCS_INTERNAL_SECRET (header x-internal-sig), and returns a Lightning invoice. Pay it, then poll get_order_status for the single-view reveal link. No Nostr identity and no partner account required.

Roadmap

  • L402 (Lightning HTTP 402) so an agent pays per-call without a human step.
  • A hosted remote MCP over HTTP, so there is nothing to install.
  • A btcrecharge MCP for mobile top-ups (same shape).

来源：README.md，提交 866b106

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分