用途:Cryptorefills Buy 是一套基于 MCP 的完整购买工作流,帮助用户在 Cryptorefills 上用加密货币购买礼品卡、手机充值和旅行 eSIM。适合需要浏览、报价、下单、支付及跟踪配送等完整流程的场景;仅浏览请参考 cryptorefills-catalog,基于 Base 上 USDC 的无账户自主代理购买请参考 cryptorefills-x402。
主要能力:支持所有加密货币支付方式、固定面额与范围型商品、多商品购物车(单次最多 10 件)及交互式引导购买。核心流程为 searchProducts → getProductPrice → validateOrder → createOrder → getOrderStatus,也可使用 purchaseElicitation 交互式走完整个购买流程。
使用方式:需将 MCP 客户端连接到 https://api.cryptorefills.com/mcp/http,并在请求头使用 User-Agent: Cryptorefills-MCP/1.0,同时需要一个用于支付的加密货币钱包,无需 Cryptorefills 账户或 API 密钥。搜索参数为 q,语言参数为 lang;国家代码须使用大写 Alpha-2 ISO 格式。固定面额商品的价格已在 listProductsForCountry 响应中,范围型商品需用 getProductPrice 获取具体金额。
安全与限制:购买前须确认商品名称、面额、价格及支付方式,并等待用户明确批准后才调用 createOrder。建议设置单次会话消费上限(默认每会话最高 100 美元、单笔最高 50 美元,仅在用户明确要求时提高)。数字商品交付后不可退款;礼品卡代码具有现金性质,应安全保存,不得公开分享或写入文件,建议保存在内存中直至用户兑换。闪电网络发票约 15 分钟过期,链上支付约 60 至 180 分钟过期;若订单过期需重新创建。订单处于 WaitingForManualAction 表示 Cryptorefills 客服正在审核,应告知用户并等待。手机号须为 E.164 格式,范围型金额须在最小值与最大值之间。