💳 stripe-mcp

Motor de pasarela Stripe, operaciones de facturación SaaS y cumplimiento fiscal para Austria y la UE

stripe-mcp es un servidor FastMCP 3.4+ y un panel webapp en React de última generación diseñado para conectar a agentes autónomos de IA (Claude Desktop, Antigravity IDE, OpenManus) y a operadores humanos con el procesamiento de pagos de Stripe, las operaciones de soporte al cliente, la gestión de suscripciones y el cumplimiento fiscal regional de Austria y la UE (IVA 20 %/10 %/13 %, inversión del sujeto pasivo ATU de la UE y retención de registros fiscales según BAO § 132).

⚡ Inicio rápido

# 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

Una vez lanzado, abre http://127.0.0.1:11166 para interactuar con el panel de la webapp.

Related MCP server: Stripe MCP Server

✨ Características principales

• 💳 Operaciones con clientes y cargos: Crea clientes, actualiza metadatos, obtienes cargos y realiza seguimiento de disputas.

• 🔁 Gestión de suscripciones: Analiza suscriptores activos, pausa, reanuda, cancela y supervisa los KPI de MRR y churn.

• 🛍️ Generador de Checkout 3DS2: Genera Stripe Payment Links y Checkout Sessions con soporte para tarjetas, EPS Online Banking y SEPA Direct Debit.

• 🛡️ Topes de seguridad financiera: Límite estricto (MAX_REFUND_AMOUNT_EUR = €500.00) que bloquea los reembolsos no autorizados por parte de los agentes.

• 🇦🇹 Cumplimiento fiscal en Austria y la UE:

  • IVA estándar automático del 20 % y tipos reducidos del 10 % / 13 % (UStG 1994).

  • Validación de sintaxis de identificación de IVA VIES/UE para una inversión del sujeto pasivo 0 % (ATU\d{8}).

  • BAO § 132: bloqueo de facturas del archivo fiscal durante 7 años.

• 🖥️ Panel webapp React de última generación (puerto 11115): Interfaz integral con Panel de control, Directorio de clientes, Gestor de suscripciones, Estudio de reembolsos, Estudio de facturas, Bandeja de entrada de webhooks, Banco de herramientas, Skills, Chat de LLM, Configuración, Ayuda y Registros de auditoría.

• ⚡ Simulación hasta que recibir de alta: Funciona de serie con datos sintéticos austriacos hasta que se conecta la Strict.

• ⚡ Física: Funciona desde el principio con datos sintéticos austríacos hasta que se conecte una clave de API restringida de Stripe (rk_test_...).

🏗️ Arquitectura

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

🇦🇸 Reglas de cumplimiento e incorporación en Austria y la UE

1. Regla de verificación de dos personas (Representante y UBO): De acuerdo con las 5ª directivas de la UE contra el lavado de dinero y con la regulación KYC de Austria, Stripeexige verificar tanto al Representante de la cuenta como a todos los Beneficiarios Finales (UBOs) con más del 25 % del capital o cos ace a los directores. Para configuraciones corporativas estándar (p. ej., una GmbH con 2 codofundadores), ambos deben presentar documentación de identidad y de domicilio.

2. Dirección (Meldegener / Meldebestätigung): Debe ser actual (con fecha de entre 3 y 6 meses). El documento de identidad con portfoto (pasaporte) y el justificante de domicilio (Meldezettel) deben ser documentos separados.

3. Leyes fiscales de Austria (UStG 1994): 20 % estándar, 10 %/13 % reducidos y el 0 % de inversión del sujeto pasivo.

4. BAO § 132: Cierre de conservación vinculante de facturas durante 7 años.

🗺️ Mapa de subdocumentación

📄 Licencia

Distribuido por la Licencia MIT. Consulta más detalle en LICENSE.