Use with Claude Code

Connect Claude Code to Bitrefill MCP to search for products, check prices, and make purchases directly from your terminal.

Prerequisites

• Claude Code CLI installed (installation guide)
• A Bitrefill account

Setup with OAuth (Recommended)

Step 1: Add the MCP Server

claude mcp add --transport http bitrefill https://api.bitrefill.com/mcp

To make it available in all projects, add the --scope user flag:

claude mcp add --transport http bitrefill https://api.bitrefill.com/mcp --scope user

Step 2: Authenticate

1. Launch Claude Code:

claude

2. Run the MCP command:

/mcp

3. Select Bitrefill and click Authenticate
4. Complete the OAuth flow in your browser
5. Return to Claude Code — you're now connected

Setup with API Key

If you prefer to use an API key:

1. Generate an API key at bitrefill.com/account/developers
2. Add the server with your API key in the URL:

claude mcp add --transport http bitrefill https://api.bitrefill.com/mcp/YOUR_API_KEY --scope user

No browser authentication needed — the API key handles it.

Configuration File

You can also add the server directly to your config file.

Global config (~/.claude.json):

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

With API key:

{
  "mcpServers": {
    "bitrefill": {
      "type": "http",
      "url": "https://api.bitrefill.com/mcp/YOUR_API_KEY"
    }
  }
}

Scope Options

For personal use, user scope is recommended so Bitrefill is available in all your projects.

Using Bitrefill

Once connected, ask Claude to use Bitrefill:

Search for Spotify gift cards in the UK

Show me eSIM options for traveling to Spain

Buy a $100 Apple gift card

Available Tools

Managing the Server

List configured MCP servers:

claude mcp list

Remove the Bitrefill server:

claude mcp remove bitrefill

Clear OAuth authentication:

/mcp

Then select Bitrefill > Clear authentication.

Troubleshooting