PayPal Agent Toolkit：让智能体开票、收款、处理争议

做外贸或接海外订单的小商家，很多时间耗在 PayPal 后台：给客户开票、催款、查某笔钱到没到、回应买家争议。PayPal Agent Toolkit 是 PayPal 官方给智能体框架准备的工具集，里面的 MCP 服务器 @paypal/mcp 把这些操作变成了智能体能直接调用的工具。截至 2026-10-06 仓库约 200 star，关注度不高，但它是 PayPal 自己维护的。

能做什么

• 发票全流程：create_invoice、send_invoice、send_invoice_reminder、cancel_sent_invoice，还能用 create_recurring_series 建定期自动发送的发票，用 generate_invoice_qr_code 生成付款二维码。
• 订单与退款：create_order、get_order、pay_order 处理订单，create_refund 对已收款的交易发起退款。
• 订阅和商品目录：建订阅计划、创建或取消订阅，管理商品目录。
• 争议与物流：list_disputes 查看未结争议，accept_dispute_claim 接受买家索赔；create_shipment_tracking 回填物流单号。
• 报表：list_transactions 按条件列交易，get_merchant_insights 取商家经营指标。

适合谁

• 用 PayPal 收款的自由职业者，想一句话让智能体开票并按月自动发送。
• 跨境小店的运营，想让智能体每天汇总交易、提醒逾期发票、回填物流单号。
• 在沙盒里验证 PayPal 收款流程的开发者。

接入方式

需要 Node.js 18+，以及 PayPal 开发者后台的 Client ID 和 Secret，先用它们换取访问令牌。客户端配置如下，PAYPAL_ENVIRONMENT 默认就是 SANDBOX：

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

编辑点评

和 Stripe 那种“搜索再调用”的通用接口不同，PayPal 把每个操作做成了一个具名工具，模型更容易选对，代价是工具多、占上下文。它最适合的是发票和订阅这类重复劳动。风险也在这里：create_refund、send_invoice、accept_dispute_claim 都会真实动钱或给客户发邮件，--tools=all 一次全开，切到 PRODUCTION 前务必收窄工具范围，并保留客户端的调用确认。访问令牌有有效期，过期要重新生成，README 对 MCP 的说明也比较简略。许可证为 Apache-2.0。