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）。

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

buy_product 与下面的 POST /api/v1/buy 运行相同的轨道——验证、预留、结算、履行，按此顺序——因此通过 MCP 找到商店的代理无需更改协议即可完成购买。第一次调用不收取任何费用，使用其他两个工具也无需钱包。

将其添加到支持远程 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: coinopai-mcp

面向代理的购买

支付方式为通过 x402 进行的 USDC on Base。一个端点，两次传递：

1. POST /api/v1/buy 携带订单主体 → 402 返回针对该确切商品定价的支付要求，以及一个 order 块（id、访问令牌、状态 URL）。

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。技能包括两个目录工具以及 buy_product，后者在此传输上携带 a2a-x402 支付扩展（https://github.com/google-a2a/a2a-x402/v0.1，声明为 required: false，因为目录技能是免费的）。

报价 → Task 处于 input-required 状态，带有 x402.payment.required；支付 → 使用相同的 taskId 和 x402.payment.payload → Task 变为 completed，并将交付作为工件。参见 examples/a2a.sh。

人工文档

商店、价格和条款：https://blinkcodes.com。支持：support@blinkcodes.com。

许可证

MIT — 适用于本仓库中的文档和示例。服务本身受网站上发布的条款约束。