MCP-сервер Paddle Billing
MCP Server for Paddle Billing
Официальный MCP-сервер Paddle Billing: каталог, клиенты, транзакции, подписки и отчеты через агента с фильтром опасных операций
Установка
{
"mcpServers": {
"paddle": {
"command": "npx",
"args": ["-y", "@paddle/paddle-mcp"],
"env": {
"PADDLE_API_KEY": "your_api_key",
"PADDLE_ENVIRONMENT": "sandbox",
"PADDLE_MCP_TOOLS": "non-destructive"
}
}
}
}PADDLE_ENVIRONMENT принимает sandbox или production. В Cursor и VS Code есть установка кнопкой из README.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер открывает агенту почти весь API Paddle Billing. Агент ведет каталог товаров, цен и скидок, смотрит клиентов, адреса и компании, создает и просматривает транзакции, получает PDF-счета. Он управляет подписками: меняет, ставит на паузу, отменяет, создает разовые списания. Есть отчеты с выгрузкой в CSV, настройки уведомлений, симуляции вебхуков и клиентские токены. Набор инструментов ограничивается режимами read-only, non-destructive, all или списком имен.
Для кого. Для разработчиков и финансовых команд продуктов, которые принимают платежи через Paddle Billing.
Подходит, если
- Нужно разобраться, почему у клиента не прошла оплата или подписка ведет себя странно
- Нужно быстро завести товары и цены в песочнице для проверки интеграции
- Нужен отчет по транзакциям или подпискам без ручной выгрузки
Не подходит, если
- Аккаунт на Paddle Classic: он не поддерживается
- Нельзя давать агенту доступ к боевым платежам и данным клиентов
Пример запроса к агенту
Найди в песочнице Paddle подписки, которые перешли в статус past_due за последнюю неделю, и покажи их транзакцииОграничения
Работает только с Paddle Billing, Classic не поддерживается. Нужен ключ API из панели Paddle, отдельный для песочницы и боевого окружения. По умолчанию загружаются только неразрушающие инструменты, режим all дает агенту отмену подписок и удаление сохраненных способов оплаты. Paddle не работает с продавцами из России, доступность API без VPN не проверена.
Как отключить. Удалите блок paddle из конфигурации MCP и отзовите ключ API в разделе Developer tools панели Paddle.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| PADDLE_API_KEY обязательная, секрет | Ключ API из Paddle, раздел Developer tools, Authentication. |
| PADDLE_ENVIRONMENT | Окружение: sandbox или production. |
| PADDLE_MCP_TOOLS | Набор инструментов: all, read-only, non-destructive (по умолчанию) или список имен через запятую. |
Проверка безопасности
- Создает транзакции и меняет подписки в платежной системе
- Имеет доступ к данным клиентов и секретному ключу API
Коротко о README
README перечисляет инструменты по группам API с отметками, какие из них только читают, а какие безопасны для записи. Установка описана тремя способами: кнопками для Cursor и VS Code, аргументами командной строки npx и переменными окружения. Отдельно объяснен фильтр инструментов и запуск локальной сборки с MCP Inspector. Лицензия Apache 2.0.
Частые вопросы
Как запретить агенту менять данные?
Задайте PADDLE_MCP_TOOLS=read-only или флаг --tools=read-only. Можно также перечислить конкретные инструменты через запятую.
Можно ли сначала попробовать без реальных денег?
Да, укажите окружение sandbox и ключ из песочницы Paddle.
Похожие
Официальные MCP-сервер, плагины и скиллы Stripe: агент ищет по API и документации, читает и меняет данные аккаунта
Официальный MCP-сервер и скиллы CCXT: рыночные данные, балансы и торговля по выбору на криптобиржах и рынках предсказаний
Плагины со скиллами для анализа акций, отчетностей, опционов и стартапов плюс чтение соцсетей и рыночных данных
Скиллы и MCP-сервер для опционных трейдеров: котировки, технический анализ, греки, спреды, сканеры и портфель Interactive Brokers