PayPal Agent Toolkit 是一个开源仓库，目标是把 PayPal 的各类 API 通过函数调用（function calling）暴露给流行的 AI 智能体框架。根据仓库说明，它支持的框架包括 OpenAI 的 Agent SDK、LangChain、Vercel 的 AI SDK 以及 Model Context Protocol（MCP）。工具包使用 TypeScript，并构建在 PayPal API 和 PayPal SDK 之上。
主要能力 工具包按业务领域提供一系列工具函数：
发票（Invoice）：创建发票、列出发票、获取发票详情、发送发票、发送提醒、取消已发送发票、生成发票二维码、删除草稿或计划中的发票、生成下一个可用发票号、搜索发票或定期发票系列、更新发票、取消自动提醒、记录外部或手动付款、记录退款、创建条件规则（如提前付款折扣或自动取消日期）、创建并激活定期发票系列、获取或取消或删除定期发票系列等。
订单（Order）：创建订单、获取订单详情、为已授权订单处理付款。
退款（Refund）：为已捕获的付款处理退款、获取退款详情。
纠纷管理（Dispute Management）：列出所有未结纠纷的摘要、获取特定纠纷的详细信息、接受纠纷索赔。
物流跟踪（Shipment Tracking）：创建物流跟踪记录、获取物流跟踪信息、更新物流跟踪信息。
商品目录管理（Catalog Management）：创建产品、列出产品、查看产品详情。
订阅管理（Subscription Management）：创建订阅计划、列出订阅计划、查看订阅计划详情、创建订阅、查看订阅详情、更新订阅、取消订阅。
报表与洞察（Reporting and Insights）：列出交易、获取商户商业智能指标与分析。
使用方式 工具包通过 npm 包使用，仓库说明中提示：除非要修改包本身，否则不需要源码，直接运行安装命令即可使用。使用前需要在配置中填写账户的 client id 与 secret，这些信息可在 PayPal Developer Dashboard 获取。工具包可与 Vercel AI SDK 配合，作为工具列表传入；更多细节可参考仓库中的 examples。要使用沙盒模式，可在配置中添加对应上下文。
环境变量 可使用以下环境变量： PAYPAL_ACCESS_TOKEN：PayPal 访问令牌； PAYPAL_ENVIRONMENT：设置为 SANDBOX 表示沙盒模式，PRODUCTION 表示生产模式，默认采用沙盒模式。
凭证与令牌 使用前需要 PayPal 开发者账户（用于沙盒）或 PayPal 商业账户（用于生产）。在 PayPal Developer Dashboard 的 Apps & Credentials 中，可切换 Sandbox 与 Live 模式，创建或查看应用，并获取 Client ID（应用公开标识）与 Client Secret（私钥，点击 Show 后显示）。生成访问令牌时，向 https://api-m.sandbox.paypal.com/v1/oauth2/token 发起 POST 请求，授权方式选择 Basic Auth 并填入 Client ID 与 Client Secret，Body 选择 x-www-form-urlencoded，添加键 grant_type，值为 client_credentials。生产环境使用 https://api-m.paypal.com 代替沙盒地址。沙盒令牌有效期为 3 至 8 小时，生产令牌有效期为 8 小时，建议在过期前实现令牌刷新逻辑。
与 Claude Desktop 集成 获得访问令牌后，可在 Claude Desktop 连接器配置中更新 PAYPAL_ACCESS_TOKEN 的值。文档同时建议安全存储 client id 与 client secret、实现令牌刷新、按环境使用令牌（测试用沙盒、真实交易用生产）、避免在应用代码中硬编码令牌。
限制与免责声明 仓库说明中提示：AI 生成的内容可能不准确或不完整，用户有责任在依赖任何信息前独立核实。PayPal 不保证输出准确性，也不对因使用该工具产生的任何决定、行动或后果承担责任。此外，仓库页面包含行为准则（Code of conduct）。
