Bitrefill

by bitrefill

3 stars

519 downloads

Not rated

GitHub Website

About

Integrates with Bitrefill's platform to search and retrieve information about gift cards, mobile refills, eSIMs, and digital services available for cryptocurrency purchases.

Details

Author: bitrefill
Repository: bitrefill/bitrefill-mcp-server
GitHub stars: 3
Downloads: 519
License: MIT License
Categories: Other, AI, Design, Developer Tools, Search, Infrastructure, API, Knowledge Base

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Bitrefill

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 bitrefill-mcp-server
Environment
- BITREFILL_API_KEY your_api_key_here
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "bitrefill": {
            "env": {
                "BITREFILL_API_KEY": "your_api_key_here"
            },
            "args": [
                "-y",
                "bitrefill-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "bitrefill": {
            "env": {
                "BITREFILL_API_KEY": "your_api_key_here"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "bitrefill-mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "bitrefill": {
            "env": {
                "BITREFILL_API_KEY": "your_api_key_here"
            },
            "args": [
                "-y",
                "bitrefill-mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "bitrefill": {
            "env": {
                "BITREFILL_API_KEY": "your_api_key_here"
            },
            "args": [
                "-y",
                "bitrefill-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "bitrefill": {
            "env": {
                "BITREFILL_API_KEY": "your_api_key_here"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "bitrefill-mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "bitrefill": {
            "env": {
                "BITREFILL_API_KEY": "your_api_key_here"
            },
            "args": [
                "-y",
                "bitrefill-mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "bitrefill": {
            "env": {
                "BITREFILL_API_KEY": "your_api_key_here"
            },
            "args": [
                "-y",
                "bitrefill-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "bitrefill": {
            "env": {
                "BITREFILL_API_KEY": "your_api_key_here"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "bitrefill-mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "bitrefill": {
            "env": {
                "BITREFILL_API_KEY": "your_api_key_here"
            },
            "args": [
                "-y",
                "bitrefill-mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "bitrefill": {
            "env": {
                "BITREFILL_API_KEY": "your_api_key_here"
            },
            "args": [
                "-y",
                "bitrefill-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "bitrefill": {
            "env": {
                "BITREFILL_API_KEY": "your_api_key_here"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "bitrefill-mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "bitrefill": {
            "env": {
                "BITREFILL_API_KEY": "your_api_key_here"
            },
            "args": [
                "-y",
                "bitrefill-mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "bitrefill": {
            "env": {
                "BITREFILL_API_KEY": "your_api_key_here"
            },
            "args": [
                "-y",
                "bitrefill-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "bitrefill": {
            "env": {
                "BITREFILL_API_KEY": "your_api_key_here"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "bitrefill-mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "bitrefill": {
            "env": {
                "BITREFILL_API_KEY": "your_api_key_here"
            },
            "args": [
                "-y",
                "bitrefill-mcp-server"
            ],
            "command": "npx"
        }
    }
}

From the repository

1. Create an API key: Bitrefill account → Developers.
2. Set in the environment (or .env for local runs):

BITREFILL_API_KEY=your_api_key_here

If BITREFILL_API_KEY is missing, no tools are registered (v2 requires authentication even for ping).

`search-products`

Search for products using a query. Parameters: q (string)

`product-details`

Retrieve details of a specific product by its ID. Parameters: id (string)

`buy-products`

Create an invoice to buy products. Parameters: product details in the request body

`get-invoice-by-id`

Retrieve a specific invoice by its ID. Parameters: id (string)

`get-order-by-id`

Retrieve a specific order by its ID. Parameters: id (string)

`list-invoices`

List all invoices associated with the account.

`list-orders`

List all orders associated with the account.

`pay-invoice`

Pay a specific invoice by its ID. Parameters: id (string)

`get-account-balance`

Retrieve the current balance of the account.

`check-phone-number`

Check the validity of a phone number. Parameters: phone number (string)

`ping`

Check the server's availability.

`list-esim-products`

List all available eSIM products.

`get-esim-product`

Retrieve details of a specific eSIM product by its ID. Parameters: id (string)

`create-esim-invoice`

Create an invoice for an eSIM product. Parameters: eSIM product details in the request body

`get-esim-invoice`

Retrieve a specific eSIM invoice by its ID. Parameters: id (string)

`pay-esim-invoice`

Pay a specific eSIM invoice by its ID. Parameters: id (string)

`list-esims`

List all eSIMs associated with the account.

`get-esim`

Retrieve details of a specific eSIM by its ID. Parameters: id (string)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "bitrefill": {
            "env": {
                "BITREFILL_API_KEY": "your_api_key_here"
            },
            "args": [
                "-y",
                "bitrefill-mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": {
        "BITREFILL_API_KEY": "your_api_key_here"
    },
    "args": [
        "-y",
        "bitrefill-mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": {
        "BITREFILL_API_KEY": "your_api_key_here"
    },
    "args": [
        "-y",
        "bitrefill-mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": {
        "BITREFILL_API_KEY": "your_api_key_here"
    },
    "args": [
        "/c",
        "npx",
        "-y",
        "bitrefill-mcp-server"
    ],
    "command": "cmd"
}

Bitrefill MCP Server (Sample Implementation)

This is a sample / reference implementation.For production use, connect to theofficial hosted Bitrefill eCommerce MCPathttps://api.bitrefill.com/mcpinstead. It is maintained by Bitrefill, supports OAuth, and exposes the same tools without you having to run, deploy, or update anything.

Use this repository if you want tolearn how a Bitrefill MCP can be built,fork it,extend it, orself-host a customized varianton top of theBitrefill API v2.

This server wraps the[Bitrefill API v2(https://api.bitrefill.com/v2) usingAuthorization: Bearer ${BITREFILL_API_KEY}. Onlyrequestparameters are validated with Zod; API responses are returned as JSON text unchanged.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

search-products

product-details

buy-products

get-invoice-by-id

get-order-by-id

list-invoices

list-orders

pay-invoice

get-account-balance

check-phone-number

ping

list-esim-products

get-esim-product

create-esim-invoice

get-esim-invoice

pay-esim-invoice

list-esims

get-esim

Claude Desktop / Cursor

Linux

Macos

Windows

Bitrefill MCP Server (Sample Implementation)

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Context 7

Reactive Resume

`search-products`

`product-details`

`buy-products`

`get-invoice-by-id`

`get-order-by-id`

`list-invoices`

`list-orders`

`pay-invoice`

`get-account-balance`

`check-phone-number`

`ping`

`list-esim-products`

`get-esim-product`

`create-esim-invoice`

`get-esim-invoice`

`pay-esim-invoice`

`list-esims`

`get-esim`