Skip to main content
Glama
prime-agent-stripe-mcp

prime-agent-stripe-mcp

by gbrlpzz

prime-agent-stripe-mcp

Offizielle Stripe MCP-Integration für Prime Agent.

CI License: MIT Python

Prime Agent verbindet sich mit dem offiziellen Remote-MCP-Server von Stripe unter https://mcp.stripe.com. Der Agent kann dann Stripe-Ressourcen über dieselbe API-Oberfläche wie andere MCP-Clients einsehen und verwalten.

[!NOTE] Der MCP-Server von Stripe befindet sich in der öffentlichen Vorschau. Er stellt sowohl Lese- als auch Schreibwerkzeuge bereit. Belassen Sie die Verbindung während der Entwicklung im Testmodus.

┌─────────────────────────────────┐                      ┌─────────────────────────────────┐
│ │ from stripe import         │  │                      │ │ mcp.stripe.com              │ │
│ │   stripe                   │  │                      │ │ API · billing · reporting   │ │
│ │ await stripe.list_tools()  │──┼   OAuth 2.1 + PKCE   │ │ products · customers        │ │
│ │ await stripe.call_tool(    │  │                      │ │ subscriptions · events      │ │
│ auth.json: mcp:stripe           │                      │ │ documentation search        │ │
└─────────────────────────────────┘                      └─────────────────────────────────┘

Warum diese Integration

  • Stripe-gehosteter Server — kein selbst gehosteter Proxy und kein Stripe-API-Schlüssel in diesem Repository.

  • Prime-Agent-nativ — das Modul erweitert McpIntegration und stellt das Live-Tool-Inventar aus dem Python-Kernel bereit.

  • OAuth 2.1 mit PKCE — die Browser-Freigabe wird ausschließlich in der privaten auth.json von Prime Agent unter mcp:stripe gespeichert.

  • Testmodus-freundlich — autorisieren Sie das Liminal-Stripe-Konto und verwenden Sie während der Entwicklung ausschließlich Testmodus-Ressourcen.

Related MCP server: Stripe MCP Server

Installation

Erfordert Prime Agent mit seinem Python-Kernel und Python 3.10 oder neuer.

  1. Klonen Sie das Repository und verlinken Sie das Skill am vorgesehenen Ort:

    git clone https://github.com/gbrlpzz/prime-agent-stripe-mcp.git ~/prime-agent-stripe-mcp
    rm -rf ~/.agents/skills/stripe
    ln -s ~/prime-agent-stripe-mcp ~/.agents/skills/stripe
  2. Installieren Sie das Paket im Editable-Modus in die Kernel-Umgebung von Prime Agent:

    uv pip install --python ~/.prime/agent/kernel-venv/bin/python -e ~/prime-agent-stripe-mcp
  3. Fügen Sie den Remote-Server einmal zu den MCP-Einstellungen von Prime Agent hinzu:

    {
      "mcpServers": {
        "stripe": {
          "type": "http",
          "url": "https://mcp.stripe.com",
          "oauth": true
        }
      }
    }
  4. Laden Sie Prime Agent neu und autorisieren Sie das Stripe-Konto:

    /reload
    /mcp login stripe

Genehmigen Sie das Liminal-Stripe-Konto, nicht ein persönliches oder Produktionskonto, das außerhalb dieses Entwicklungsworkflows bleiben sollte. Prime Agent speichert die Zugangsdaten als mcp:stripe. Sie werden niemals in dieses Repository geschrieben.

Verwendung

from stripe import stripe, auth_status

print(auth_status())               # credential state, no token values
tools = await stripe.list_tools()  # live Stripe MCP inventory
# Inspect the live schema before calling a read or write tool.
result = await stripe.call_tool("<live-tool-name>", {"<live-argument>": "..."})

auth_status() gibt ein kleines Dict ohne Geheimnisse zurück:

{"enabled": True, "expires_fresh": True, "type": "oauth"}

Toolnamen und Parameter gehören zu Stripe und können sich während der öffentlichen Vorschau ändern. Rufen Sie zuerst list_tools() auf, oder verwenden Sie die Methoden, die automatisch aus dem Live-Inventar gebunden werden.

Der Server enthält Tools für die Stripe-API-Discovery, API-Lese- und Schreiboperationen, Kontoinformationen, Billing-Ressourcen, Dokumentation und Reporting. Schreiboperationen verändern Stripe-Daten. Bitten Sie um eine menschliche Bestätigung, bevor Sie etwas erstellen, aktualisieren, stornieren, erstatten oder löschen.

Fallback für die Token-Aktualisierung

Prime Agent aktualisiert das gespeicherte Token automatisch. Auf Hosts, auf denen das nicht verfügbar ist, rufen Sie den Fallback auf Modulebene auf:

from stripe import refresh

refresh()  # exchanges the stored refresh token; rewrites auth.json with mode 600

Liminal-Entwicklungsworkflow

  1. Fügen Sie Ihren persönlichen Benutzer als Teammitglied des Liminal-Stripe-Kontos hinzu.

  2. Autorisieren Sie diese Integration als dieser Benutzer.

  3. Stellen Sie sicher, dass sich das Stripe-Dashboard im Testmodus befindet.

  4. Erstellen Sie ausschließlich Testprodukte, Testpreise, Testkunden und Testabonnements.

  5. Konfigurieren Sie die Supabase-Funktion stripe-webhook separat mit dem resultierenden Test-Webhook-Signaturgeheimnis. Die MCP-Zugangsdaten ersetzen nicht das serverseitige STRIPE_SECRET_KEY bzw. STRIPE_WEBHOOK_SECRET.

Fehlerbehebung

Symptom

Behebung

auth_status() meldet keine Zugangsdaten

Führen Sie /mcp login stripe erneut aus.

Aufrufe schlagen nach einer langen Pause fehl

Führen Sie refresh() aus; melden Sie sich erneut an, wenn False zurückgegeben wird.

Ein Toolname ist unbekannt

Führen Sie await stripe.list_tools() erneut aus; das Inventar kann sich während der Vorschau ändern.

Entwicklung

python3 tests/test_skill.py                             # standalone suite, no Prime Agent needed
~/.prime/agent/kernel-venv/bin/python -m pytest tests/  # inside Prime Agent's kernel

CI führt die eigenständige Testsuite bei jedem Push auf main aus.

Sicherheit

  • In diesem Repository und seiner Git-Historie befinden sich keine Zugangsdaten.

  • OAuth-Tokens befinden sich ausschließlich in der privaten auth.json von Prime Agent.

  • Das Modul kommuniziert nur mit https://mcp.stripe.com und dem OAuth-Autorisierungsserver von Stripe.

  • Führen Sie alle Entwicklungsänderungen ausschließlich im Stripe-Testmodus durch.

  • Fügen Sie Stripe-Geheimwerte oder privates Schlüsselmaterial niemals in Quellcode, Tests, Dokumentation oder Git-Historie ein.

Lizenz

MIT — siehe LICENSE. Stripe ist eine Marke von Stripe, Inc.; dies ist eine unabhängige Client-Integration für den offiziellen MCP-Server von Stripe (siehe NOTICE).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables natural language interaction with Stripe accounts to query customers, revenue, invoices, subscriptions, disputes, and issue refunds.
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables integration with Stripe APIs through function calling, supporting operations on customers, products, invoices, subscriptions, and more.
      31,367 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to query Stripe operations such as customers, recent charges, duplicate charges, and revenue summaries through read-only MCP tools.
      4
      MIT