💳 stripe-mcp

Stripe-Gateway, SaaS-Abrechnungsbetriebe & österreichische/EU-Steuerkonformitäts-Engine

stripe-mcp ist ein FastMCP 3.4+ Server und ein SOTA React Webapp Dashboard, das entwickelt wurde, um autonome KI-Agenten (Claude Desktop, Antigravity IDE, OpenManus) und menschliche Betreiber mit der Stripe-Zahlungsabwicklung, Kundensupport-Operationen, Abonnementverwaltung und österreichischer/EU-regionaler Steuerkonformität (USt 20 %/10 %/13 %, EU-ATU-Reverse-Charge und BAO-§ 132-Aufbewahrungspflicht für Steuerbelege) zu verbinden.

⚡ Schnellstart

# Navigate to repository
cd D:\Dev\repos\stripe-mcp

# Install dependencies via uv
uv sync

# Launch Backend (Port 11165) & React Webapp (Port 11166)
.\start.ps1

Öffnen Sie nach dem Start http://127.0.0.1:11166, um über das Webapp-Dashboard zu interagieren.

Related MCP server: Stripe MCP Server

✨ Hauptfunktionen

• 💳 Kunden- & Zahlungsvorgänge: Kunden anlegen, Metadaten aktualisieren, Zahlungen abrufen und Dispute nachverfolgen.

• 🔁 Abonnementverwaltung: Aktive Abonnenten beobachten, Abos pausieren, fortsetzen, kündigen und MRR- & Churn-KPIS im Blick behalten.

• 🛍️ 3DS2 Checkout Generator: Stripe Payment Links & Checkout Sessions generieren – mit Unterstützung für Karten, EPS-Online-Banking und SEPA-Direct Debit.

• 🛡️ Finanzielle Sicherheitslimits: Strenges Festlimit (MAX_REFUND_AMOUNT_EUR = €500,00) verhindert unbefugte Erstattungsüberschreitung durch Agenten.

• 🇦🇹 Österreichische & EU-Steuerkonformität:

  • Automatische 20 % Standard-Umsatzsteuer, 10 %/13 % ermäßigte Sätze (UStG 1994).

  • VIES/EU-UVA-ID-Syntaxprüfung für 0 % Reverse-Charge (ATU\d{8}).

  • BAO § 132 – 7-jährige steuerliche Aufbewahrungssperre für Rechnungen (Metadaten).

• 🖥️ SOTA React-Webapp-Dashboard (Port 11165): „Catch-them-all“-UI mit Dashboard, Kundenverwaltung, Abonnement-Manager, Refund Studio, Invoice Studio, Webhook-Eingang, Tools-Workbench, Skills, LLM-Chat, Einstellungen, Hilfe und Audit-Logs.

• ⚡ Mock-until-Onboarded: Funktioniert sofort out of the box mit synthetischen österreichischen Daten, bis Sie Ihren Stripe Restricted API Key (rk_test_...) anschließen.

🏗️ Architektur

+-----------------------------------------------------------------------+
|                             AI AGENT HOST                             |
|          (Claude Desktop / Antigravity IDE / OpenManus / Cursor)      |
+-----------------------------------------------------------------------+
                                   |
                         (FastMCP stdio / HTTP /mcp)
                                   v
+-----------------------------------------------------------------------+
|                    stripe-mcp FastMCP 3.4+ SERVER                     |
|                           (Port 11165 REST/MCP)                       |
|                                                                       |
|  +------------------------+  +-------------------------------------+  |
|  |  austria_tax.py Engine |  |  Portmanteau Tools                  |  |
|  |  - 20%/10%/13% VAT       |  |  - manage_stripe_customers          |  |
|  |  - ATU Syntax Checker  |  |  - manage_stripe_subscriptions      |  |
|  |  - Reverse Charge      |  |  - manage_stripe_payments         |  |
|  |  - BAO § 132 Metadata  |  |  - manage_stripe_checkout         |  |
|  +------------------------+  +-------------------------------------+  |
+-----------------------------------------------------------------------+
            |                                           |
    (Stripe REST API)                           (SSE & REST /api)
            v                                           v
+-----------------------+               +-------------------------------+
|  Stripe Cloud Platform|               | React + Vite Webapp Dashboard |
|  - API Gateway        |               |          (Port 11166)         |
|  - Webhooks Ingest    |               | - Hero & KPIs (MRR/VAT)       |
|  - EPS / SEPA / PSD2  |               | - Mock-until-onboarded        |
+-----------------------+               | - Catch-them-all Pages        |
                                        +-------------------------------+

🇦🇹 Österreichische & EU-Compliance- und Onboarding-Regeln

1. Zwei-Personen-Regel (Vertreter & UBO): Gemäß der EU-5-Geldwäscherichtlinie und den österreichischen KYC-Regelungen verlangt Stripe, sowohl den Vertreter als auch alle wirtschaftlich Berechtigten (UBOs) – also die unmittelbar oder mittelbar >25 % Kapitalanteile oder Mitbestimmung haben – zu verifizieren. Für typische Unternehmensstrukturen (z. B. GmbH mit 2 Co-Foundern) müssen beide Personen einen Identitäts- und Adressnachweis einreichen.

2. Adressnachweis (Meldezettel / Meldebestätigung): Muss aktuell sein (nicht älter als 3 bis 6 Monate). Lichtbildausweis (Reisepass) und Adressnachweis (Meldezettel) müssen jeweils getrennte Dokumente sein.

3. UStG 1994 – Umsatzsteuergesetz: 20 % Regelsatz, 10 %/13 % ermäßigte Sätze und 0 % Reverse-Charge-Nullbesteuerung.

4. BAO § 132: Pflicht zur 7-jährigen Rechnungsaufbewahrung (gesetzlich bindend).

🗺️ Unterdokumentations-Übersicht

| Bereich | Dokumentations-Link | Beschreibung | | -------------- ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------- | | 🖥️ Webapp-Dashboard | webapp/README.md | React-18-, Vite-, TailwindCSS-Dashboard: Anleitung und Einrichtung. | | 🐍 Python-Backend | src/stripe_mcp/README.md | Referenz für FastMCP-Server, Tools und Tax-Engine. | | 📚 Master-Docs-Stack | docs/README.md | Index für Onboarding-, Konfigurations-, Tool- und Troubleshooting-Anleitungen. | | 📖 System- und Hilfemanual | docs/HELP.md | Vollständiges Stripe-Systemhandbuch, Flotten-Integrationskarte und KYC-Regeln. | | 🚀 Onboarding-Runbook | docs/ONBOARDING.md | Schritt-für-Schritt-Anleitung zur Registrierung und Meldezettel-Verifizierung. | | ⚙️ Konfiguration | docs/CONFIGURATION.md | Umgebungsvariablen und Einstellungen zu Finanz-/Sicherheitscaps. | | 🛠️ Tools-Referenz | docs/TOOLS.md | Vollständige Parameterschemata & Rückgabetypen für alle Tools. | | 📝 MCPB-Prompts | assets/prompts/README.md | MCPB 3-4-100 Metrik- & Validierungsprüfung. | | 🧪 Test-Suite | tests/README.md | Pytest-Testliste und Compliance-Assertions. | | 🔧 Skripte | scripts/README.md | Wartungs- und MCPB-Paketskripte. |

📄 Lizenzisc

Distributed unter der MIT-Lannzenzztg. Einzelheiten siehe LICENSE.