PayPal Agent Toolkit MCP: Документация
Обновлено:
Подключение
npx -y @paypal/mcp --tools=all (stdio). Переменные окружения PAYPAL_CLIENT_ID и PAYPAL_CLIENT_SECRET из PayPal Developer Dashboard — сервер сам обменивает их на Bearer-токен по OAuth client credentials; либо готовый PAYPAL_ACCESS_TOKEN. Флагом --tools= можно включить не всё, а только нужные группы (например, invoices,orders). Для тестов передаётся sandbox: true в конфигурации — тогда все операции идут в PayPal Sandbox, а не в LIVE-окружение.
Инструменты
27+ инструментов по 6 группам:
- Счета:
create_invoice,list_invoices,get_invoice,send_invoice,send_invoice_reminder,cancel_sent_invoice,generate_invoice_qr_code. - Платежи:
create_order,get_order,pay_order,create_refund,get_refund. - Споры:
list_disputes,get_dispute,accept_dispute_claim. - Доставка:
create_shipment_tracking,get_shipment_tracking,update_shipment_tracking. - Каталог:
create_product,list_products,show_product_details. - Подписки:
create_subscription_plan,list_subscription_plans,create_subscription,update_subscription,cancel_subscription. - Отчётность:
list_transactions,get_merchant_insights.
Сценарий для агента
«Выставь счёт клиенту на 450 $ и пришли ссылку на оплату», «прими спор по заказу #4471 и оформи возврат», «заведи новый тарифный план подписки на 19 $ в месяц», «покажи метрики мерчанта за квартал».
Важно
Ключи PayPal дают прямой доступ к деньгам продавца: агент с полным набором инструментов может создавать возвраты и принимать споры. Начинайте с sandbox-окружения и ограниченного набора --tools=, переходите в LIVE только после проверки сценариев.
Тарифы
MCP-сервер и пакет @paypal/agent-toolkit бесплатны (open source); комиссии — по обычным тарифам PayPal за приём платежей.