Bitrefill — MCP-сервер для Claude Code: что делает и как установить
Обёртка над Bitrefill API v2: агент ищет подарочные карты и eSIM, выставляет счета, платит и смотрит заказы.
лицензия не указана обновлён 2026-10-29
Открыть на GitHubЧто делает Bitrefill
Сервер оборачивает Bitrefill API v2 и отдаёт агенту 18 инструментов: поиск товаров и карточка товара, создание счёта и его оплата, статус заказа, баланс аккаунта, проверка номера и набор вызовов для eSIM. Схемы Zod стоят только на входных параметрах, а ответы Bitrefill приходят к модели как есть, без переупаковки.
Запуск локальный, по stdio: в конфиг клиента идёт npx -y bitrefill-mcp-server, ключ BITREFILL_API_KEY передаётся через env. Ключ выдают в кабинете Bitrefill на странице для разработчиков. Без него не зарегистрируется ни один инструмент, даже ping: v2 требует авторизацию всегда. Ресурсы bitrefill://payment-methods и bitrefill://category-slugs подсказывают агенту допустимые строки оплаты и категорий, чтобы он их не сочинял.
Это образец для изучения и форка, а не готовый сервис. У Bitrefill есть свой хостед-эндпоинт https://api.bitrefill.com/mcp с OAuth и урезанным набором из 7 инструментов — для продакшна нужен он. Ещё одна ловушка при переезде с 0.x: имена инструментов в snake_case удалены, unseal_order больше нет, код пополнения приходит в ответе на заказ.
Какие задачи решает
- найти подарочную карту нужного магазина и номинала
- выставить счёт и оплатить его прямо из агента
- проверить статус заказа и забрать код пополнения
- подобрать eSIM и выпустить на неё инвойс
- посмотреть остаток на аккаунте Bitrefill перед покупкой
Примеры запросов агенту
- Найди подарочную карту Steam и покажи, какие способы оплаты доступны.
- Создай счёт на эту карту, оплати его и пришли статус заказа.
- Подбери eSIM под поездку и выставь на неё инвойс.
Как установить Bitrefill
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Bitrefill
Как установить Bitrefill в Claude Code?
Сначала заведите ключ в кабинете Bitrefill на странице для разработчиков. Потом добавьте сервер в MCP-конфиг клиента: команда npx -y bitrefill-mcp-server, ключ BITREFILL_API_KEY в блоке env. После перезапуска клиента инструменты появятся в списке.
Что делает Bitrefill MCP-сервер?
Даёт агенту доступ к Bitrefill: искать карты и eSIM, создавать и оплачивать счета, смотреть заказы и баланс аккаунта. В этой сборке 18 инструментов.
Что нужно, чтобы сервер заработал?
Ключ BITREFILL_API_KEY в окружении процесса. Без него сервер не зарегистрирует ни одного инструмента, потому что v2 требует авторизацию даже для ping.