Cryptorefills primary sources — 2026-05-02

Project status in this pass

• No canonical standalone whitepaper or litepaper surfaced.
• The clearest current source of truth is Cryptorefills’ official site, partner API/docs surface, AI-agent pages, machine-readable discovery files, and first-party GitHub agent-skills repo.
• The official materials reveal a broader commerce-control-plane and agent-native purchase layer than the storefront alone suggests.

Primary-source snapshots

1) Homepage

• URL: https://www.cryptorefills.com/
• Key excerpt:
  • The homepage says users can choose from 6,600+ gift cards, eSIMs, flights, stays, and mobile top-ups, pay with BTC, ETH, USDT, USDC, and many more, and receive products instantly.
  • It also includes a dedicated “Built for AI agents” section that says skills, MCP, and x402 let agents quote, validate, and buy products autonomously with stablecoins.
  • This is an early clue that Cryptorefills is not positioning itself only as a consumer storefront.

2) API landing page

• URL: https://www.cryptorefills.com/en/api-docs
• Key excerpt:
  • The page explicitly calls Cryptorefills “the stablecoin checkout API for gift cards, mobile top-ups and eSIMs.”
  • It describes a four-step flow of search, quote, pay, and deliver and says inventory can be issued at checkout time instead of pre-buying stock.
  • It also claims support for 15+ coins across Solana, Base, Arbitrum, Polygon, Lightning, and other networks, reinforcing that the platform sits above several crypto payment rails.

3) Developer API reference

• URL: https://www.cryptorefills.com/en/api-docs/developers
• Key excerpt:
  • The reference documents required headers such as X-Cr-Application, X-Cr-Version, and X-Country-ISO-Code, which indicates a formal partner API rather than a purely public storefront.
  • It exposes endpoints for payment rails, brand catalogs, homepage feeds, country product lists, stablecoin price conversion, order validation, and order creation.
  • It also documents both SSE-based order-status subscriptions and polling fallback, which is a strong sign of an operational checkout-and-delivery control plane.

4) AI agents page

• URL: https://www.cryptorefills.com/en/ai-agents
• Key excerpt:
  • The page says Cryptorefills is the first platform where AI agents can autonomously search, quote, and purchase gift cards and mobile top-ups using stablecoins.
  • It documents three skills: cryptorefills-catalog, cryptorefills-buy, and cryptorefills-x402, splitting read-only discovery, full purchase flow, and fully autonomous wallet-based commerce into separate agent surfaces.
  • It also publishes MCP endpoint details, workflow names, and an OpenClaw-specific implementation checklist, which is unusually explicit agent-platform support for a crypto-commerce company.

5) llms.txt

• URL: https://www.cryptorefills.com/llms.txt
• Key excerpt:
  • The file says Cryptorefills supports 10,500+ brands across 180+ countries and frames the API as “agent-native.”
  • It lists machine-readable discovery resources including an API catalog, MCP manifest, agent-skills index, and health probe.
  • It also states that MCP and x402 flows work without account, OAuth, or API-key provisioning, which is a major clue that Cryptorefills is designing for low-friction machine access and not only conventional partner onboarding.

6) MCP manifest

• URL: https://api.cryptorefills.com/.well-known/mcp.json
• Key excerpt:
  • The manifest defines the Cryptorefills HTTP MCP server at https://api.cryptorefills.com/mcp/http and requires the User-Agent: Cryptorefills-MCP/1.0 header.
  • It includes structured quick-start steps, supported languages, and concrete purchase examples for fixed-denomination products, range-based gift cards, gift cards delivered by email, and mobile top-ups delivered to phone numbers.
  • This shows that Cryptorefills is publishing a serious machine-consumable contract for conversational or tool-using agents rather than only marketing MCP at a high level.

7) Agent-skills index

• URL: https://api.cryptorefills.com/.well-known/agent-skills/index.json
• Key excerpt:
  • The discovery file lists cryptorefills-buy, cryptorefills-catalog, and cryptorefills-x402 with descriptions and SHA-256 digests.
  • The descriptions reinforce support for Bitcoin, Lightning, Ethereum, Solana, USDC, USDT, and other assets across 180+ countries.
  • The existence of a published skill index is another clue that the company is treating agent access as a first-class product surface.

8) Supplier / partner page

• URL: https://www.cryptorefills.com/en/consumer-and-digital-brands
• Key excerpt:
  • The page positions Cryptorefills as a route to crypto-owning consumers and says brands can reach users directly and through partners such as Binance.
  • It says the platform accepts Lightning and major cryptocurrencies and describes two direct supply models: API integration for certain brands or stocked-code relationships.
  • This matters because it shows that Cryptorefills is not only demand-side checkout infrastructure; it also organizes upstream supply and distribution relationships.

9) GitHub agents repo

• URL: https://github.com/Cryptorefills/agents
• Key excerpt:
  • The repo describes agent skills for buying gift cards, top-ups, and eSIMs with crypto through MCP or x402, with no account, CLI install, or API key required for the skill path.
  • It repeats the split between cryptorefills-catalog, cryptorefills-buy, and cryptorefills-x402, and documents MCP plus x402 endpoints.
  • The repo is useful corroboration that the agent-facing surface is not just marketing copy on the main website.

Working conclusion

Cryptorefills is best cataloged as crypto spending and agentic-commerce infrastructure rather than as only a gift-card site. The decisive evidence in this pass was the combination of a consumer marketplace, a partner-authenticated checkout API, public MCP and agent-skill discovery surfaces, autonomous x402 purchase flows, and supplier-side API/stock partnership models. One notable caveat is that different official pages disagree on catalog scale, citing either 6,600+ or 10,500+ brands/products, so the exact count should be treated cautiously until the company standardizes its public materials.