PayPal Agent Toolkit

Официальный набор PayPal для агентов: MCP-сервер и SDK для счетов, заказов, подписок, возвратов и споров

MCP-серверВысокий риск

paypal/agent-toolkit

Установка

{
   "mcpServers": {
     "paypal": {
       "command": "npx",
       "args": [
         "-y",
         "@paypal/mcp",
         "--tools=all"
       ],
       "env": {
         "PAYPAL_ACCESS_TOKEN": "YOUR_PAYPAL_ACCESS_TOKEN",
         "PAYPAL_ENVIRONMENT": "SANDBOX"
       }
     }
   }
}

Та же конфигурация подходит для Cursor и Cline. Для боевого режима PAYPAL_ENVIRONMENT=PRODUCTION.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Репозиторий содержит MCP-сервер и библиотеку, которая отдает API PayPal агентам как набор функций. Агент создает и отправляет счета, в том числе повторяющиеся, оформляет заказы и возвраты, ведет каталог товаров и планы подписок. Также он просматривает споры и транзакции, добавляет трекинг доставки и получает сводные метрики продавца. Библиотека подключается к OpenAI Agents SDK, LangChain и Vercel AI SDK, а в конфигурации можно включить только нужные действия.

Для кого. Для продавцов и разработчиков, которые принимают оплату через PayPal вне России.

Подходит, если

  • Нужно выставлять и отслеживать счета PayPal из агента
  • Нужно разобрать открытые споры и транзакции
  • Нужно встроить платежи PayPal в собственного агента на AI SDK или LangChain

Не подходит, если

  • Бизнес работает в России: PayPal здесь не обслуживает платежи
  • Агенту нельзя доверять операции с деньгами без проверки человеком

Пример запроса к агенту

Покажи мои неоплаченные счета PayPal и отправь напоминание по самым старым

Ограничения

Нужен аккаунт PayPal Developer для песочницы и бизнес-аккаунт для боевого режима. PayPal не работает с российскими пользователями. Локальный сервер принимает токен доступа, который живет несколько часов и требует обновления. Удаленный сервер входит через учетную запись PayPal. Ответы модели PayPal просит проверять самостоятельно.

Как отключить. Удалите блок paypal из конфигурации MCP и перезапустите клиент, затем отзовите токен или доступ приложения в PayPal Developer Dashboard.

MCP

Транспорт
stdio, sse, http
Авторизация
OAuth
Переменные окружения
Переменные окружения
PAYPAL_ACCESS_TOKEN
обязательная, секрет
Токен доступа PayPal для локального сервера
PAYPAL_ENVIRONMENT
SANDBOX или PRODUCTION, по умолчанию SANDBOX

Проверка безопасности

  • Проводит оплату заказов и возвраты
  • Отправляет счета клиентам и меняет подписки

Коротко о README

README перечисляет инструменты по группам: счета, платежи, споры, доставка, каталог, подписки и отчеты. Показана установка библиотеки @paypal/agent-toolkit для TypeScript, выбор разрешенных действий и режим песочницы. В README пакета TypeScript есть запуск MCP-сервера через npx @paypal/mcp и конфигурация для Claude Desktop. Отдельно расписано получение токена доступа.

Частые вопросы

Как получить токен?

Создайте приложение в PayPal Developer Dashboard и обменяйте client ID и secret на токен запросом к /v1/oauth2/token, пример есть в README.

Есть удаленный сервер?

Да, в документации PayPal указаны адреса mcp.paypal.com и mcp.sandbox.paypal.com с транспортами SSE и HTTP, вход через учетную запись PayPal.

Выбор редакции

Официальные MCP-сервер, плагины и скиллы Stripe: агент ищет по API и документации, читает и меняет данные аккаунта

MCP-серверВысокий риск1,8 тыс.

Официальный MCP-сервер и скиллы CCXT: рыночные данные, балансы и торговля по выбору на криптобиржах и рынках предсказаний

MCP-серверВысокий риск44 тыс.

Плагины со скиллами для анализа акций, отчетностей, опционов и стартапов плюс чтение соцсетей и рыночных данных

ПлагинСредний риск3,3 тыс.

Скиллы и MCP-сервер для опционных трейдеров: котировки, технический анализ, греки, спреды, сканеры и портфель Interactive Brokers

MCP-серверВысокий риск365