PayPal Agent Toolkit MCP — インストール & ライブデモ

Name: PayPal Agent Toolkit MCP Server
Author: paypal

なぜ使うのか

主な機能

Create and send invoices to any email
Capture or refund existing transactions
Manage subscription plans and billing agreements
List transactions with date/status filters
Sandbox + live mode with separate credentials

ライブデモ

実際の動作

paypal-agent-toolkit-mcp.replay ▶ 準備完了

0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "paypal-agent-toolkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@paypal/agent-toolkit",
        "mcp"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "paypal-agent-toolkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@paypal/agent-toolkit",
        "mcp"
      ]
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "paypal-agent-toolkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@paypal/agent-toolkit",
        "mcp"
      ]
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "paypal-agent-toolkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@paypal/agent-toolkit",
        "mcp"
      ]
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "paypal-agent-toolkit-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@paypal/agent-toolkit",
        "mcp"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json

{
  "context_servers": {
    "paypal-agent-toolkit-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@paypal/agent-toolkit",
          "mcp"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add paypal-agent-toolkit-mcp -- npx -y @paypal/agent-toolkit mcp

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方： PayPal Agent Toolkit

Send an invoice to a freelance client from a conversation

👤 Solo operators, freelancers ⏱ ~15 min intermediate

使うタイミング： Client just confirmed scope in chat — you want the invoice out before context-switching.

前提条件

Server/skill installed and authenticated — See repo README

フロー

Draft the invoice

Create a PayPal invoice for [email protected] for $2,400 USD: 1 line item 'May consulting retainer, 24h @ $100'. Due net-15.✓ コピーしました

→ Invoice id + payment link
Confirm and send

Send the invoice now and tell me the URL to copy into email.✓ コピーしました

→ Sent status + URL

結果： Invoice issued in 30 seconds without leaving the chat.

注意点

Always start in sandbox. Live mode is one env var away from being real money. Set PAYPAL_ENVIRONMENT=sandbox until you've tested the exact f — Always start in sandbox. Live mode is one env var away from being real money. Set PAYPAL_ENVIRONMENT=sandbox until you've tested the exact flow.

組み合わせ： gmail · filesystem

組み合わせ

他のMCPと組み合わせて10倍の力を

paypal-agent-toolkit-mcp + gmail

Pair with gmail for complementary capabilities

Use this server together with gmail to complete a multi-step task.✓ コピーしました

paypal-agent-toolkit-mcp + filesystem

Pair with filesystem for complementary capabilities

Use this server together with filesystem to complete a multi-step task.✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング	コスト
create_invoice	recipient_email, items, currency	Bill a client	1 API call
list_transactions	start_date, end_date, status	Reconcile or audit	1 API call
refund_capture	capture_id, amount	Issue a refund	1 API call

コストと制限

運用コスト

APIクォータ: See provider docs for rate limits
呼び出しあたりのトークン: Varies by tool
金額: See repo README for pricing details
ヒント: Cache tool results and avoid repeated identical calls.

セキュリティ

権限、シークレット、影響範囲

認証情報の保管： Use environment variables; never commit secrets

データ送信先： Tool calls go to the provider's API as documented

トラブルシューティング

よくあるエラーと対処法

AUTHENTICATION_FAILURE

Generate a REST app at developer.paypal.com → My Apps & Credentials → REST API apps. Set PAYPAL_CLIENT_ID and PAYPAL_CLIENT_SECRET.

確認： list_transactions for the last 7 days

PERMISSION_DENIED on refund

Refund permission requires the parent capture to be in COMPLETED state and the merchant account to allow refunds.

確認： Check the capture status first

代替案

PayPal Agent Toolkit 他との比較

代替案	代わりに使う場面	トレードオフ
Stripe Agent Toolkit	You're on Stripe	Stripe-only; otherwise similar scope

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る