BlinkCodes catalog

Name: BlinkCodes catalog
Author: blinkcodes.com

远程服务

blinkcodes.com商业与营销09 周前更新

代码仓库访问官网

关于 BlinkCodes catalog

BlinkCodes catalog 是 BlinkCodes 商店的远程 MCP 服务，提供礼品卡、充值和旅行 eSIM 的目录查询与购买。目录查询免费且只读，购买通过 x402 完成。

主要功能

01搜索礼品卡、充值和 eSIM
02查看商品价格与库存
03查询面额及兑换限制
04通过 x402 购买商品

适用场景

01查找可购买的礼品卡或充值
02核对商品价格和兑换国家
03通过 MCP 流程下单并接收交付

MCP 相关

提供远程 MCP 服务，包含目录搜索、商品详情和购买工具。前两项免费只读；购买使用 x402 支付。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://blinkcodes.com/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http com-blinkcodes-catalog https://blinkcodes.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"com-blinkcodes-catalog":{"type":"http","url":"https://blinkcodes.com/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"com-blinkcodes-catalog":{"type":"http","url":"https://blinkcodes.com/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"com-blinkcodes-catalog":{"type":"http","url":"https://blinkcodes.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"com-blinkcodes-catalog":{"serverUrl":"https://blinkcodes.com/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

参数	类型	必填	说明
type	enum	否	voucher = 礼品卡，recharge_fixed / recharge = 充值，e_sim = eSIM 数据套餐。voucher \| recharge_fixed \| recharge \| e_sim
limit	integer	否	返回商品的数量上限（默认 10，最大 50）。
query	string	否	与产品名称和品牌匹配的自由文本，例如 "steam" 或 "playstation"。
country	string	否	产品适用国家/地区的 ISO-3166-1 alpha-2 国家/地区代码，例如 US、TR。

详细介绍

BlinkCodes Agent 接口

blinkcodes.com 的机器可读接口——这是一个销售礼品卡代码、服务充值和旅行 eSIM 的商店，可在数秒内通过电子邮件送达。

这里的所有内容都是远程托管服务。无需安装任何内容，也无需运行服务：将客户端指向以下 URL 即可。此代码库用于记录这些端点、固定其架构，并提供可用示例。

接口	端点	规范
MCP（目录 + 购买）	`https://blinkcodes.com/mcp`	Streamable HTTP，协议 `2025-06-18`
A2A	`https://blinkcodes.com/a2a`	JSON-RPC，协议 `0.3`
x402（按调用付费）	`https://blinkcodes.com/api/v1/buy`	x402 v2（可按需使用 v1），Base 上的 USDC
OpenAPI	`https://blinkcodes.com/openapi.json`	包含 `x-payment-info`（MPP）
面向 Agent 的自然语言文档	`https://blinkcodes.com/llms.txt`

发现文档：/.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 服务

已作为 com.blinkcodes/catalog 发布至 Official MCP Registry（server.json）。

提供三个工具。两个目录工具是只读且免费的——无需密钥、账户或付款。第三个工具会收款，且仅通过 x402 收款：

工具	用途
`search_catalog`	搜索礼品卡、充值和 eSIM 套餐。返回价格、库存情况和产品 URL。
`get_product`	根据 ID 查询单个产品：面额及价格、必需的下单信息、无法兑换代码的国家/地区。
`buy_product`	购买并接收交付内容。分两次调用：传入参数 → 返回 x402 付款要求；传入签名载荷 → 返回代码。

buy_product 使用与下方 POST /api/v1/buy 相同的流程——依次验证、预留、结算、履行订单——因此，通过 MCP 找到商店的 Agent 无需切换协议即可完成购买。首次调用不会扣款，使用另外两个工具也无需钱包。

将其添加到支持远程 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——桥接程序只会多增加一跳，并无额外收益。

供 Agent 购买

付款方式为 Base 上的 USDC，使用 x402。一个端点，两次请求：

使用订单正文调用 POST /api/v1/buy → 返回 402，其中包含针对该商品的付款要求，以及一个 order 块（id、访问令牌、状态 URL）。
使用 PAYMENT-SIGNATURE 标头发送完全相同的请求 → 返回 200 和代码；如果履约时间超出同步窗口，则返回 202 和 status_url。

// the body, in both passes
{
  "email": "[email protected]",
  "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

Agent 卡片位于 /.well-known/agent-card.json，JSON-RPC message/send 位于 https://blinkcodes.com/a2a。技能包括两个目录工具和 buy_product；通过此传输方式使用 buy_product 时，会携带 a2a-x402 付款扩展（https://github.com/google-a2a/a2a-x402/v0.1，声明为 required: false，因为目录技能是免费的）。

报价 → 返回 input-required 状态的 Task，其中包含 x402.payment.required；付款 → 使用相同的 taskId 并附上 x402.payment.payload → 返回状态为 completed 的 Task，并将交付内容作为资源提供。参见 examples/a2a.sh。