Bitrefill MCP Server

How It Works

1. Runs as a standalone process using stdio for communication

2. Registers resources and tools for accessing Bitrefill services

3. Interfaces with the Bitrefill API to provide product search and details

4. Returns structured JSON responses that can be processed by AI assistants

Architecture

Features

Resources

• `bitrefill://product-types` - List of available product types on Bitrefill

• `bitrefill://categories/{type}` - List of available categories for a specific product type (e.g., `bitrefill://categories/gift-cards`)

Tools

• `search` - Search for gift cards, esims, mobile topups and more - Required: `query` (e.g., 'Amazon', 'Netflix', 'AT&T' or '*' for all) - Optional: `country`, `language`, `limit`, `skip`, `category`

• `detail` - Get detailed information about a product - Required: `id` (product identifier)

• `categories` - Get the full product type/categories map - No required parameters

• `create_invoice` - Create a new invoice for purchasing products (requires API key) - Required: `products` (array of products to include in the invoice) - Each product requires: `product_id` - Optional product fields: `quantity`, `value`, `package_id`, `phone_number`, `email`, `send_email`, `send_sms` - Required: `payment_method` (one of: "balance", "bitcoin", "lightning") - Optional: `webhook_url`, `auto_pay`

• `get_invoices` - Retrieve a list of invoices with optional filtering - Optional: `start`, `limit`, `after`, `before`

• `get_invoice` - Retrieve details for a specific invoice by ID - Required: `id` (invoice identifier)

• `pay_invoice` - Pay an unpaid invoice (only works with 'balance' payment method) - Required: `id` (invoice identifier)

• `get_orders` - Retrieve a list of orders with optional filtering - Optional: `start`, `limit`, `after`, `before`

• `get_order` - Retrieve details for a specific order by ID - Required: `id` (order identifier)

• `unseal_order` - Reveal codes and PINs for a specific order by ID - Required: `id` (order identifier)

• `get_account_balance` - Retrieve your account balance - No required parameters

• `ping` - Check if the Bitrefill API is available - No required parameters

Configuration

API Key Setup

1. Create a Bitrefill account

2. Ask for a developer API key by filing a request on [this form](https://bitrefill.typeform.com/to/BDmIVEsH?typeform-source=www.github.com)

3. Create a `.env` file in the root directory (you can copy from `.env.example`)

4. Add your Bitrefill API credentials: ``` BITREFILL_API_SECRET=your_api_key_here BITREFILL_API_ID=your_api_id_here ```

Development

Debugging

Installation

Installing via Smithery

Claude Desktop

• MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`

• Windows: `%APPDATA%/Claude/claude_desktop_config.json`

Cline

1. Open the Cline extension settings

2. Open "MCP Servers" tab

3. Click on "Configure MCP Servers"

4. Add the server config:

• `disabled`: Set to `false` to enable the server

• `autoApprove`: List of tools that don't require explicit approval for each use

Cursor

1. Open the Cursor settings

2. Open "Features" settings

3. In the "MCP Servers" section, click on "Add new MCP Server"

4. Choose a name, and select "command" as "Type"

5. In the "Command" field, enter the following:

1. (Optional) If you're using the `create_invoice` tool, add environment variables: - BITREFILL_API_SECRET: your_api_key_here - BITREFILL_API_ID: your_api_id_here

Docker