Name: Bitrefill
Author: bitrefill

LABSCO SUMMARY

This one can spend money: four of its eighteen tools create or pay for real orders, so decide what an agent may call before you connect it.

The repository calls itself a sample: for production, Bitrefill points you to its hosted server at api.bitrefill.com/mcp, which signs you in over OAuth and exposes a curated set of 7 tools. Run this one when you want the full 18, a fork you can extend, or a copy inside your own network. Two resources save guesswork: bitrefill://category-slugs holds the category values product search expects, and bitrefill://payment-methods lists the only payment_method strings buy-products and create-esim-invoice accept.

What it is

A sample MCP server over Bitrefill API v2 that searches the catalogue and places orders: gift cards and eSIMs, invoices and orders, the account balance and a phone-number check. Without BITREFILL_API_KEY it registers no tools at all.

What you get

Catalogue lookups: search-products searches or browses products, and product-details returns one by id.
Buying: buy-products creates an invoice and pay-invoice pays it; get-invoice-by-id, list-invoices, get-order-by-id and list-orders follow it up, and a delivered order carries its redemption_info.
eSIMs end to end: list-esim-products and get-esim-product to choose a plan, create-esim-invoice and pay-esim-invoice to buy it, and get-esim-invoice, list-esims and get-esim to check on it.
Account and checks: get-account-balance, check-phone-number and ping — plus resources listing the accepted payment methods, the category slugs and the product families.

Requirements

A Bitrefill API key, supplied as BITREFILL_API_KEY.

Setup effort

One command plus a key — npx -y bitrefill-mcp-server, then supply credentials

See installation options

USE CASES

01

Checking whether Bitrefill covers a brand or a country before you promise it

Look up the category slugs first so the query lands somewhere real, search the catalogue, then open the matching product in full.

02

Telling an outage apart from a query that matched nothing

When a search comes back empty, check the API separately instead of guessing whether the outage or the query is at fault.

ping

18 tools

Listed in project docs. Your client may show a different list.

search-products

product-details

buy-products

get-invoice-by-id

get-order-by-id

list-invoices

list-orders

pay-invoice

get-account-balance

check-phone-number

ping

list-esim-products

get-esim-product

create-esim-invoice

get-esim-invoice

BEFORE YOU INSTALL

What to know first

Tools you get

18 tools named in the project's documentation. The official hosted server exposes a curated set of 7. The old 0.x names search, detail, categories and ping were removed. buy-products, pay-invoice, pay-esim-invoice and create-esim-invoice create and pay for real orders.

Requires

npx on PATH
BITREFILL_API_KEY in your environment

Where it runs

Of the 3 documented clients, 2 run the server on your machine and 1 connects to a hosted endpoint.

INSTALLATION

Connect your client

Server setup

npx

TERMINAL

npx -y bitrefill-mcp-server

Hosted endpoint

ENDPOINT URL

https://api.bitrefill.com/mcp

Add this hosted endpoint to your MCP client, then sign in.

MCP Clients

Cursor — npx, Claude Desktop — npx

JSON

{
  "mcpServers": {
    "bitrefill": {
      "command": "npx",
      "args": [
        "-y",
        "bitrefill-mcp-server"
      ],
      "env": {
        "BITREFILL_API_KEY": "<YOUR_BITREFILL_API_KEY>"
      }
    }
  }
}

Any MCP client — remote

ANY MCP CLIENT — REMOTE · JSON

{
  "mcpServers": {
    "bitrefill": {
      "url": "https://api.bitrefill.com/mcp"
    }
  }
}

Bitrefill