Bitrefill MCP Server

@MCP-Mirror

About Bitrefill MCP Server

Mirror of

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "bitrefill_bitrefill-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@bitrefill/bitrefill-mcp-server",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

Search for gift cards, esims, mobile topups and more

Get detailed information about a product

Get the full product type/categories map

Create a new invoice for purchasing products (requires API key)

Retrieve a list of invoices with optional filtering

Retrieve details for a specific invoice by ID

Pay an unpaid invoice (only works with 'balance' payment method)

Retrieve a list of orders with optional filtering

Retrieve details for a specific order by ID

Reveal codes and PINs for a specific order by ID

Retrieve your account balance

Check if the Bitrefill API is available

Overview

What is Bitrefill MCP Server?

A TypeScript-based MCP server that provides access to Bitrefill services, allowing AI assistants to search for gift cards, mobile topups, eSIMs, and more. It implements the Model Context Protocol to expose Bitrefill functionality to AI assistants like Claude.

How to use Bitrefill MCP Server?

Install via npm (npx -y bitrefill-mcp-server) and configure with API credentials from a Bitrefill account. Add to your MCP client config (Claude Desktop, Cline, or Cursor) pointing to either npx or Docker. The server communicates over stdio; environment variables BITREFILL_API_SECRET and BITREFILL_API_ID are required for tools that create invoices or manage orders.

Key features of Bitrefill MCP Server

Search for gift cards, mobile topups, eSIMs, and more
Get detailed product information by ID
Browse product types and categories
Create and pay invoices (requires API key)
Retrieve invoices and orders with filtering
Unseal orders to reveal codes and PINs
Check account balance and ping the API
Works without API key for search, detail, and categories tools

Use cases of Bitrefill MCP Server

AI assistant searches for available gift cards from a brand like Amazon or Netflix
Automating mobile topup purchases for a list of phone numbers
Checking account balance before creating a new invoice
Unsealing and delivering order codes to end users

FAQ from Bitrefill MCP Server

Which tools work without an API key?

search, detail, and categories work without API credentials. All other tools (including create_invoice, get_invoices, pay_invoice, get_orders, get_order, unseal_order, and get_account_balance) require a valid Bitrefill API key. The create_invoice tool is only registered if API credentials are set.

How does the server communicate with AI assistants?

It uses the Model Context Protocol (MCP) over stdio as its transport layer.

What runtime or dependencies does it need?

It runs on Node.js and is written in TypeScript. The server can be run directly with npx, installed locally via npm, or deployed via Docker.

Where does data live and travel?

All product and order data is retrieved live from the Bitrefill API. No data is stored locally; everything flows through the MCP server in real time.

How do I get Bitrefill API credentials?

Create a Bitrefill account, then request a developer API key by filing a request on the Bitrefill Typeform linked in the README.

Frequently asked questions

Which tools work without an API key?

`search`, `detail`, and `categories` work without API credentials. All other tools (including `create_invoice`, `get_invoices`, `pay_invoice`, `get_orders`, `get_order`, `unseal_order`, and `get_account_balance`) require a valid Bitrefill API key. The `create_invoice` tool is only registered if API credentials are set.

How does the server communicate with AI assistants?

It uses the Model Context Protocol (MCP) over stdio as its transport layer.

What runtime or dependencies does it need?

It runs on Node.js and is written in TypeScript. The server can be run directly with `npx`, installed locally via npm, or deployed via Docker.

Where does data live and travel?

All product and order data is retrieved live from the Bitrefill API. No data is stored locally; everything flows through the MCP server in real time.

How do I get Bitrefill API credentials?

Create a Bitrefill account, then request a developer API key by filing a request on the Bitrefill Typeform linked in the README.

Comments

Basic information

More Other MCP servers

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K