cryptorefills-catalog

Cryptorefills 目录 — 浏览与搜索

仅用于只读产品发现。当用户想要探索、搜索、比较或了解 Cryptorefills 提供的产品时，请使用此技能。

如需购买，请遵循以下说明：

• cryptorefills-buy — 提供所有加密货币支付方式的引导式 MCP 购买工作流
• cryptorefills-x402 — 使用 Base 上的 USDC 进行自主 Agent 商务（无需账户）

当用户的意图从浏览转为购买时，请停止使用此技能的工具，并切换到上述相应购买技能的说明。

何时启用

• 用户询问可用 Bitcoin、Ethereum、Solana、USDC 或其他加密货币购买的礼品卡、手机充值或 eSIM 的搜索、浏览或比较
• 用户提到 Cryptorefills，或想了解某个国家/地区有哪些商品
• 用户询问价格、供应情况、支持的国家/地区或支付货币
• 用户想要特定语言的目录信息
• 关键词：“查找礼品卡”“有哪些品牌”“旅行用 eSIM”“手机充值”“在［国家/地区］可用”“用 bitcoin 购买”“用 ethereum 购买”“用 solana 购买”“加密货币礼品卡”

MCP 连接

字段	值
服务 URL	https://api.cryptorefills.com/mcp/http
传输方式	HTTP
必需标头	User-Agent: Cryptorefills-MCP/1.0

在 Claude Code MCP 设置中配置：

{
  "mcpServers": {
    "cryptorefills": {
      "url": "https://api.cryptorefills.com/mcp/http",
      "headers": { "User-Agent": "Cryptorefills-MCP/1.0" }
    }
  }
}

可用工具

工具	用途
searchProducts	按品牌名称、国家/地区、语言和类别进行全文搜索
listBrands	浏览某个国家/地区的所有可用品牌
listProductsForCountry	某个国家/地区的完整产品目录，可按品牌/系列/币种筛选
getCurrencies	列出支持的支付加密货币及其状态
getPaymentViasWithCurrencies	列出与支持货币和网络对应的支付方式

快速决策树

User intent
├─ "Find me a specific brand" → searchProducts(country_code=XX, q=brand)
├─ "What's available in [country]?" → listBrands(country_code=XX)
├─ "Show me all [category] options" → listProductsForCountry(country_code=XX, family=...)
├─ "What crypto can I pay with?" → getCurrencies() or getPaymentViasWithCurrencies()
└─ "I want to buy"
   ├─ Agent has USDC wallet on Base + can sign EIP-712 → cryptorefills-x402
   └─ Otherwise (human-guided, multi-currency) → cryptorefills-buy

任务流程

按品牌搜索

1. 询问用户品牌名称和国家/地区
2. 使用 country_code（大写：US、IT、BR）和 q（搜索文本）调用 searchProducts
3. 展示匹配的产品、面额和价格
4. 如果用户想购买 → 切换到 cryptorefills-buy 说明

按国家/地区浏览

1. 询问用户所在的国家/地区（或根据上下文判断）
2. 使用 country_code 调用 listBrands
3. 按 category 分组展示品牌（例如：e-commerce、games、streaming）
4. 用户选择品牌后 → 调用 listProductsForCountry 获取详情

探索类别

1. 针对用户所在的国家/地区调用 listBrands
2. 按 category 字段对结果分组——类别根据响应动态发现，而非硬编码
3. 展示类别及品牌数量
4. 通过筛选结果深入查看某个类别

查看支付选项

1. 调用 getCurrencies 展示支持的币种
2. 调用 getPaymentViasWithCurrencies 获取网络详情
3. 展示包含链/资产信息的支付方式

多语言

向工具传递 lang 参数。支持：en、es、fr、de、it、pt、zh、tr、vi、tl。如果无法使用所选语言，则回退到英语。

品牌名称匹配

API 响应中的品牌名称可能带有后缀（例如，“Claro Credits”而非“Claro”，“Vivo Credits”而非“Vivo”，“Everything Apple”而非“Apple”）。始终使用 listBrands 返回的确切 brand 值——部分匹配会失败。

提示

• 国家/地区代码 — 使用大写的 ISO 3166-1 Alpha-2 代码（例如：US、IT、BR）。注意：x402 技能使用小写——端点不同，格式也不同
• 国家/地区必须与产品区域一致 — 美国礼品卡只能在美国使用
• 电话号码 — 手机充值需要使用 E.164 格式（+1234567890）
• 区间产品 — 建议金额前，检查 is_dynamic 标记和 min/max 值
• 促销活动 — listBrands 支持促销代码和客户 ID 参数

限制

此技能为只读，无法创建订单或处理付款。

• 购买产品 → 切换到 cryptorefills-buy（支持所有付款方式，提供引导式流程）
• 由自主 Agent 购买 → 切换到 cryptorefills-x402（使用 Base 上的 USDC，无需账户）

参考资料

只有当你需要了解本技能文件中未涵盖的深入信息时，才加载参考资料。

文件	加载时机……	内容
references/product-types.md	用户询问产品类型差异、固定金额与范围金额的区别，或交付详情	礼品卡、手机充值、eSIM — 详细指南
references/search-guide.md	需要了解 MCP 工具调用的准确参数名称或类型	MCP 工具参数、示例、搜索策略
references/categories.md	用户询问可用类别，或需要核实品牌名称	类别体系、各国家/地区的已核实品牌