广告合作
MCP.so
登录

Bitrefill MCP Server

@bitrefill

代码仓库主页

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

bitrefill

关于 Bitrefill MCP Server

A Model Context Protocol Server connector for Bitrefill public API, to enable AI agents to search and shop on Bitrefill.

#agent#ai#mcp#claude#mcp-server

Bitrefill MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Bitrefill MCP Server 工具

4

Search for gift cards, esims, mobile topups and more. It's suggested to use the `categories` tool before searching for products, to have a better understanding of what's available.

Get detailed information about a product

Get the full product type/categories map. It's suggested to use this tool to get the categories and then use the `search` tool to search for products in a specific category.

Check if the Bitrefill API is available

概览

What is Bitrefill MCP Server?

The Bitrefill MCP Server is a sample/reference implementation that wraps the Bitrefill API v2 using a Bearer token. It is intended for developers who want to study, fork, extend, or self-host a customized MCP server on top of the Bitrefill API. For production use, a hosted remote MCP server is recommended instead.

How to use Bitrefill MCP Server?

Set the BITREFILL_API_KEY environment variable with an API key from the Bitrefill Developers page. The server exposes 18 tools that map to Bitrefill v2 endpoints. For production, connect to the hosted remote MCP at https://api.bitrefill.com/mcp (with OAuth or an API key in the URL).

Key features of Bitrefill MCP Server

  • Wraps 18 Bitrefill v2 API endpoints as MCP tools
  • Input validation via Zod schemas
  • Includes resources for allowed payment methods, categories, and product types
  • Supports self-hosting for private or air‑gapped environments
  • Sample implementation for learning and customization

Use cases of Bitrefill MCP Server

  • Study a working reference implementation of a Bitrefill MCP server
  • Fork and add custom tools, prompts, or validation logic
  • Self‑host inside a private network or air‑gapped environment
  • Experiment with a wider set of v2 endpoints than the curated production server

常见问题

1

How does this sample differ from the official hosted MCP?

The official hosted MCP (at `https://api.bitrefill.com/mcp`) is maintained by Bitrefill, supports OAuth, and exposes a curated set of 7 tools. This sample exposes 18 tools and is meant for learning, forking, or self‑hosting.

2

What authentication does the sample use?

The sample requires a `BITREFILL_API_KEY` environment variable. Requests are authenticated with `Authorization: Bearer ${BITREFILL_API_KEY}`.

3

What dependencies are needed to run the sample locally?

Node.js, pnpm (`pnpm install`, `pnpm run build`), and a valid Bitrefill API key from the Developers page.

4

What tools are available in the sample?

The 18 tools cover products, invoices, orders, account balance, phone number checks, ping, and a full eSIM workflow (list, get, create‑invoice, pay‑invoice, list, get).

5

How do I test the sample locally?

Run `pnpm run build && pnpm run smoke` for in‑process MCP client tests, or use the MCP Inspector with `pnpm run inspector`. Smoke tests only target the built server, not the remote hosted MCP.

评论

其他 分类下的更多 MCP 服务器

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K
广告合作