用途:Cryptorefills Catalog 是只读的商品发现技能,用于浏览、搜索、比较和了解 Cryptorefills 上可购买的商品,包括礼品卡、手机充值和 eSIM。当用户从浏览转为购买时,应改用 cryptorefills-buy(引导式 MCP 购买流程)或 cryptorefills-x402(在 Base 上以 USDC 自主购买,无需账户)。
主要能力:通过 MCP 提供 searchProducts(按品牌名、国家、语言、品类文本搜索)、listBrands(浏览某国全部品牌)、listProductsForCountry(某国完整商品目录,可按品牌/系列/货币筛选)、getCurrencies(列出支持的支付加密货币及状态)、getPaymentViasWithCurrencies(支付方式与支持的货币和网络对应)。
使用方式:MCP 服务器地址为 https://api.cryptorefills.com/mcp/http,传输方式为 HTTP,必须带请求头 User-Agent: Cryptorefills-MCP/1.0。可在 Claude Code MCP 设置中按资料给出的 JSON 配置。部分工具支持 lang 参数,可选 en、es、fr、de、it、pt、zh、tr、vi、tl,缺失时回退英文。国家代码使用大写 ISO 3166-1 Alpha-2(如 US、IT、BR);x402 技能用小写,端点不同。品牌名需使用 listBrands 返回的精确值(如 "Claro Credits"、"Vivo Credits"、"Everything Apple"),部分匹配会失败。
适用场景:查找特定品牌、了解某国有哪些品牌、按品类探索、查询支持的支付币种与网络、获取指定语言的目录信息。
限制:本技能为只读,不能创建订单或处理支付;购买需切换到上述购买技能。国家须与商品区域匹配(美国礼品卡仅限美国使用)。手机充值需 E.164 格式号码(+1234567890)。动态范围商品需先检查 is_dynamic 标志及 min/max 值。listBrands 支持促销码和客户 ID 参数。更详细内容可按需加载 references/product-types.md、references/search-guide.md、references/categories.md。