stripe-mcp
💳 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
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.
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.
UStG 1994 – Umsatzsteuergesetz: 20 % Regelsatz, 10 %/13 % ermäßigte Sätze und 0 % Reverse-Charge-Nullbesteuerung.
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.
This server cannot be deployed
Maintenance
Related MCP Connectors
Stripe payments for AI agents. Create links, verify, manage customers.
Luxembourg payments for AI agents — cards / Apple Pay via Stripe. Never holds funds.
Austria payments for AI agents — EPS via Stripe. Never holds funds.
Estonia payments for AI agents — cards / Apple Pay via Stripe. Never holds funds.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables AI agents to interact with multiple payment providers (Stripe, Paystack) through a unified API. Supports payment initialization, verification, refunds, customer management, and invoicing without requiring knowledge of specific provider implementations.2-
- AlicenseNot gradedqualityDmaintenanceEnables natural language interaction with Stripe accounts to query customers, revenue, invoices, subscriptions, disputes, and issue refunds.48 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables integration with Stripe APIs through function calling, supporting operations on customers, products, invoices, subscriptions, and more.21,738 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to accept payments in Austria via Stripe hosted checkout, supporting EPS, cards, and Apple Pay.MIT