# Bitrefill

A sample MCP server over the Bitrefill v2 API: the agent can search gift cards and eSIMs, raise invoices, pay them and check orders.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: bitrefill
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bitrefill/bitrefill-mcp-server
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/bitrefill

## What it does

The repo is a worked example of an MCP server sitting on top of Bitrefill's v2 HTTP API. It hands the agent 18 tools: product search and details, invoice creation and payment, order lookup, account balance, a phone-number check, plus a group of eSIM calls. Zod schemas cover the tool inputs only — whatever Bitrefill sends back reaches the model as plain JSON, untouched.

It runs locally over stdio. Your client config points at `npx -y bitrefill-mcp-server` and passes `BITREFILL_API_KEY` in the `env` block; the key comes from the developers page of a Bitrefill account. Skip the key and nothing is registered at all, not even `ping`, since v2 always wants auth. Four resources (`bitrefill://payment-methods`, `bitrefill://category-slugs`, `bitrefill://product-types`) feed the agent the allowed strings so it stops guessing them.

Treat the code as a starting point rather than a service. Bitrefill runs its own endpoint at `https://api.bitrefill.com/mcp` with OAuth and a trimmed set of 7 tools, and that is the one to use in production. Upgrading from 0.x breaks things too: the old snake_case tool names are gone, `unseal_order` no longer exists, and redemption details now come back in the order response.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- find a gift card for a given store and amount
- create a crypto invoice and pay it from the agent
- check an order and pull the redemption code
- pick an eSIM and issue its invoice
- read the account balance before buying

## Example prompts
- Find a gift card for Steam and list the payment methods I can use.
- Create the invoice, pay it, then tell me the order status.
- Pick an eSIM for a trip and create the invoice for it.

## Similar
- [gift-cards](https://affpapa.org/en/nevibecode/mcp/gift-cards.md) — MCP server · 1864 installs
- [agentroam](https://affpapa.org/en/nevibecode/mcp/agentroam.md) — MCP server · 2149 installs
- [gift-up](https://affpapa.org/en/nevibecode/skills/gift-up.md) — skill · 159 installs
- [Buy UK eSIM](https://affpapa.org/en/nevibecode/mcp/buy-uk-esim.md) — MCP server · 1005 installs
- [AskMia.app travel eSIM AI shop](https://affpapa.org/en/nevibecode/mcp/askmiaapp-travel-esim-ai-shop.md) — MCP server · 1591 installs
- [pikasim](https://affpapa.org/en/nevibecode/mcp/pikasim.md) — MCP server · 1059 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
