/ Verzeichnis / Playground / PayPal Agent Toolkit
● Offiziell paypal ⚡ Sofort

PayPal Agent Toolkit

von paypal · paypal/agent-toolkit

Official PayPal MCP — invoices, payments, subscriptions, refunds.

PayPal's official Agent Toolkit ships an MCP server that lets Claude (and other agents) create invoices, capture payments, issue refunds, and manage subscriptions on a real PayPal merchant account — sandbox or live.

Warum nutzen

Hauptfunktionen

Live-Demo

In der Praxis

paypal-agent-toolkit-mcp.replay ▶ bereit
0/0

Installieren

Wählen Sie Ihren Client

~/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"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "paypal-agent-toolkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@paypal/agent-toolkit",
        "mcp"
      ]
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "paypal-agent-toolkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@paypal/agent-toolkit",
        "mcp"
      ]
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "paypal-agent-toolkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@paypal/agent-toolkit",
        "mcp"
      ]
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

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

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json
{
  "context_servers": {
    "paypal-agent-toolkit-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@paypal/agent-toolkit",
          "mcp"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

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

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: PayPal Agent Toolkit

Send an invoice to a freelance client from a conversation

👤 Solo operators, freelancers ⏱ ~15 min intermediate

Wann einsetzen: Client just confirmed scope in chat — you want the invoice out before context-switching.

Voraussetzungen
  • Server/skill installed and authenticated — See repo README
Ablauf
  1. 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.✓ Kopiert
    → Invoice id + payment link
  2. Confirm and send
    Send the invoice now and tell me the URL to copy into email.✓ Kopiert
    → Sent status + URL

Ergebnis: Invoice issued in 30 seconds without leaving the chat.

Fallstricke
  • 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.
Kombinieren mit: gmail · filesystem

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

paypal-agent-toolkit-mcp + gmail

Pair with gmail for complementary capabilities

Use this server together with gmail to complete a multi-step task.✓ Kopiert
paypal-agent-toolkit-mcp + filesystem

Pair with filesystem for complementary capabilities

Use this server together with filesystem to complete a multi-step task.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

WerkzeugEingabenWann aufrufenKosten
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

Kosten & Limits

Was der Betrieb kostet

API-Kontingent
See provider docs for rate limits
Tokens pro Aufruf
Varies by tool
Kosten in €
See repo README for pricing details
Tipp
Cache tool results and avoid repeated identical calls.

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: Use environment variables; never commit secrets
Datenabfluss: Tool calls go to the provider's API as documented

Fehlerbehebung

Häufige Fehler und Lösungen

AUTHENTICATION_FAILURE

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

Prüfen: 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.

Prüfen: Check the capture status first

Alternativen

PayPal Agent Toolkit vs. andere

AlternativeWann stattdessenKompromiss
Stripe Agent ToolkitYou're on StripeStripe-only; otherwise similar scope

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen