purchaseElicitationLABSCO SUMMARY
Agent-side commerce: pick the product, sign the payment, get the voucher back.
The catalog is read-only and the order path is a fixed sequence — price, validate, create, pay, poll — so an agent completes a purchase without custom glue code. For agents with little context to spare, one stateful tool runs the same flow as a question-and-answer loop.
What it is
Cryptorefills' MCP server at https://api.cryptorefills.com/mcp/http, exposing its catalog and purchase flow to any MCP client. Three skills arrive over that one connection: catalog discovery, the order lifecycle, and walletless payment over x402.
What you get
- Discovery across brands and categories: searchProducts, listBrands, listProductsForCountry, getProductPrice
- The purchase lifecycle: validateOrder, createOrder, getOrderStatus, getCurrencies
- getPaymentViasWithCurrencies for the payment methods, currencies and networks on offer
- purchaseElicitation — a stateful loop that walks a small-context agent through a purchase one question at a time
- x402 payment on Base with EIP-712-signed USDC, and on Solana with ed25519-signed USDC through a dedicated subdomain
- An OpenAPI spec covering every product, price and endpoint
- Catalog coverage across 6,600+ brands in 180+ countries, searchable in 15 languages
Requirements
No account and no API key for the catalog and order tools; requests carry the header User-Agent: Cryptorefills-MCP/1.0. Paying over x402 on Base needs USDC and a signing key.
Setup effort
One command — npx skills add cryptorefills/agents
USE CASES
01
Buying a gift card on request
Find the brand for the country, check whether it takes a fixed denomination or a range, then validate and create the order.
02
Paying without provisioning API keys
Settle over x402: EIP-712-signed USDC on Base, or ed25519-signed USDC on Solana.
03
Delivering to someone else
Set the beneficiary on the order and poll until the voucher lands.
04
Running the purchase from a small agent
Start with an empty body, answer each question it returns, and validation and order creation are handled for you.
05
Checking what you can pay with first
List the supported coins and the payment methods and networks behind them.
10 tools
Listed in project docs. Your client may show a different list.
getCurrencieslistBrandslistProductsForCountrygetPaymentViasWithCurrenciesgetProductPricevalidateOrdercreateOrdergetOrderStatussearchProductsBEFORE YOU INSTALL
What to know first
Tools you get
10 tools named in the project's documentation. Workflow names such as browse_catalog and the purchaseGiftCard prompt are not tools. createOrder and purchaseElicitation place orders.
INSTALLATION
Connect your client
Server setup
npx
TERMINAL
npx skills add cryptorefills/agentsHosted endpoint
ENDPOINT URL
https://api.cryptorefills.com/mcp/httpAdd this hosted endpoint to your MCP client.
MCP Clients
Claude Code
CLAUDE CODE · IN CLIENT
/plugin marketplace add cryptorefills/agents
/plugin install cryptorefills@cryptorefills-skillsClaude Desktop — Cowork
Settings > Plugins
Add marketplace cryptorefills/agents
Install cryptorefills
Cursor
CURSOR · TERMINAL
npx skills add cryptorefills/agents -a cursor -yAny MCP client
URL: https://api.cryptorefills.com/mcp/http
Header: User-Agent: Cryptorefills-MCP/1.0
