Use with Claude Desktop

Connect Claude Desktop to Bitrefill MCP for purchasing gift cards and eSIMs.

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

Prerequisites

  • Claude Desktop installed (download)
  • A Claude Pro, Max, Team, or Enterprise subscription
  • A Bitrefill account

Claude Desktop uses OAuth for remote MCP servers. You'll sign in to Bitrefill when you first connect — no API key needed.

Setup

Remote MCP servers are added through the Claude Desktop UI, not the config file.

Step 1: Open Connectors Settings

  1. Open Claude Desktop
  2. Go to Settings > Connectors

Step 2: Add Bitrefill MCP

  1. Click Add custom connector at the bottom
  2. Enter the server URL:
https://api.bitrefill.com/mcp
  1. Click Add

Step 3: Authorize Access

Claude will redirect you to Bitrefill:

  1. Sign in to your Bitrefill account
  2. Review the permissions requested
  3. Click Approve to grant access

The connector will show as connected with a green checkmark.

Team/Enterprise Setup

Workspace owners add the connector first:

  1. Go to Admin settings > Connectors
  2. Click Add custom connector
  3. Enter https://api.bitrefill.com/mcp
  4. Click Add

Team members then connect:

  1. Go to Settings > Connectors
  2. Find "Bitrefill" under Custom connectors
  3. Click Connect and authorize

Using Bitrefill in Claude

Once connected, ask Claude to use Bitrefill:

"Find Netflix gift cards available in Germany"

"What eSIM options are there for a trip to Thailand?"

"Purchase a $25 Uber Eats gift card"

Available Tools

ToolWhat It Does
search-productsFind gift cards and eSIMs
product-detailsGet pricing and denominations
buy-productsPurchase products
list-invoicesView your invoices
get-invoice-by-idGet invoice details
list-ordersView your orders
get-order-by-idGet order details

Alternative: API Key Setup

If you prefer to use an API key instead of OAuth:

  1. Generate an API key at bitrefill.com/account/developers
  2. When adding the connector, use this URL instead:
https://api.bitrefill.com/mcp/YOUR_API_KEY

Troubleshooting

Can't find Connectors setting

Remote MCP server support requires Claude Pro, Max, Team, or Enterprise. Free plans don't have access to custom connectors.

OAuth flow not starting

If the browser doesn't open:

  1. Try clicking Connect again
  2. Check your browser isn't blocking pop-ups
  3. Try using a different browser
Connection issues after authorization

If connection issues occur, try appending /sse to the URL:

https://api.bitrefill.com/mcp/sse