Bitrefill MCP Server
@MCP-Mirror
About Bitrefill MCP Server
Mirror of
Basic information
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
12Search 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.
More Other MCP servers
MCP Go 🚀
mark3labsA Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.
XcodeBuildMCP
cameroncookeA Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Core Philosophy: Connect, Unify, Respond
mindsdbDelegate anything. It comes back done.
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.
Comments