Abstraxn Agent Kit supports Bitrefill for searching and purchasing gift cards, eSIMs, and mobile refills using your Bitrefill API key (BYOK). Agents call bitrefill_search_products, bitrefill_get_product, bitrefill_buy_gift_card, and bitrefill_get_invoice. Unlike read-only integrations, purchasing a gift card may require an on-chain x402 crypto payment if the Bitrefill account balance can’t cover the cost.

​
Dashboard setup

  1. Open Agentic Stack → Integrations for your application.
  2. Enable Bitrefill and paste your API key from Bitrefill’s developer dashboard.
  3. Save — credentials are encrypted server-side and included in agent validation for MCP calls.
Bitrefill credentials are stored per application, not per end user. All agents under that app share the integration when enabled.

​
MCP tool: bitrefill_search_products

Search Bitrefill gift cards, eSIMs, and mobile refill products by keyword, country, or category. Returns a list of matching products. If disabled, returns BITREFILL_NOT_ENABLED.

​
MCP tool: bitrefill_get_product

Get product details — pricing, denominations/packages, recipient requirements, and payment methods. Always call this before bitrefill_buy_gift_card to confirm the exact denomination/package and price with the user. Returns product details. If disabled, returns BITREFILL_NOT_ENABLED.

​
MCP tool: bitrefill_buy_gift_card

Purchase a gift card, eSIM, or mobile refill. This spends real money against the user’s Bitrefill account balance/payment method. If the Bitrefill account balance can’t cover the purchase, this tool returns a payment required challenge instead of failing — retry tools/call with the same arguments plus a signed paymentPayload to complete payment automatically. See x402 payments and MCP tools reference for the full retry flow. Returns the created invoice (id, status, payment link, expiration) and, if a crypto payment was made, a paymentReceipt. If disabled, returns BITREFILL_NOT_ENABLED.

​
MCP tool: bitrefill_get_invoice

Check the status and redemption details of a Bitrefill invoice after purchase. Returns invoice status and, once complete, the gift card redemption code. If disabled, returns BITREFILL_NOT_ENABLED.

​
Specialist agents

​
Limitations

  • Available products, denominations, and regions depend on Bitrefill’s live catalog
  • Available payment methods depend on how the Bitrefill account is configured
  • Purchases spend real balance/funds — always confirm the exact product, denomination, and payment method with the user before calling bitrefill_buy_gift_card
  • Not a substitute for Bitrefill’s own dashboard for account-level management (balance top-ups, order history beyond a single invoice, etc.)

Third-party integrations

BYOK overview and architecture.

MCP tools reference

Full tool catalog.

x402 payments

Payment-required retry flow for paid tools.

Dashboard setup

Agentic Stack navigation.