💳 stripe-mcp

Stripe Gateway, SaaS Billing Ops & Austrian/EU Tax Compliance Engine

stripe-mcp is a FastMCP 3.4+ server and SOTA React webapp dashboard designed to connect autonomous AI agents (Claude Desktop, Antigravity IDE, OpenManus) and human operators with Stripe payment processing, customer support operations, subscription management, and Austrian/EU regional tax compliance (VAT 20%/10%/13%, EU ATU Reverse Charge, and BAO § 132 fiscal record retention).

⚡ Quick Start

# 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

Once launched, open http://127.0.0.1:11166 to interact with the webapp dashboard.

Related MCP server: Stripe MCP Server

✨ Key Features

• 💳 Customer & Charge Operations: Create customers, update metadata, fetch charges, and track disputes.

• 🔁 Subscription Management: Track active subscribers, pause, resume, cancel, and monitor MRR & churn KPIs.

• 🛍️ 3DS2 Checkout Generator: Generate Stripe Payment Links & Checkout Sessions supporting Cards, EPS Online Banking, and SEPA Direct Debit.

• 🛡️ Financial Safety Caps: Strict hard limit (MAX_REFUND_AMOUNT_EUR = €500.00) blocking unauthorized agent refund overruns.

• 🇦🇹 Austrian & EU Tax Compliance:

  • Automatic 20% Standard VAT, 10% / 13% Reduced Rates (UStG 1994).

  • VIES/EU VAT ID syntax validation for 0% Reverse Charge (ATU\d{8}).

  • BAO § 132 7-year fiscal invoice archive lock metadata.

• 🖥️ SOTA React Webapp Dashboard (Port 11166): Catch-them-all UI with Dashboard, Customer Directory, Subscription Manager, Refund Studio, Invoice Studio, Webhook Inbox, Tools Workbench, Skills, LLM Chat, Settings, Help, and Audit Logs.

• ⚡ Mock-until-Onboarded: Works out of the box with synthetic Austrian data until your Stripe Restricted API Key (rk_test_...) is connected.

🏗️ Architecture

+-----------------------------------------------------------------------+
|                             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        |
                                        +-------------------------------+

🇦🇹 Austrian & EU Compliance & Onboarding Rules

1. Two-Person Verification Rule (Representative & UBOs): Under EU 5th AML directives and Austrian KYC regulations, Stripe requires verifying both the Account Representative AND all Ultimate Beneficial Owners (UBOs) holding >25% equity or co-managing directors. For standard corporate setups (e.g. GmbH with 2 co-founders), both persons must submit identity & address proof.

2. Proof of Address (Meldezettel / Meldebestätigung): Must be fresh (dated within 3 to 6 months). Photo ID (passport) and proof of address (Meldezettel) must be separate documents.

3. Austrian Tax Act (UStG 1994): 20% Standard, 10%/13% Reduced, and 0% Reverse Charge zero-rating.

4. BAO § 132: Mandatory 7-year statutory invoice retention lock.

🗺️ Sub-Documentation Map

📄 License

Distributed under the MIT License. See LICENSE for details.