# Notsy Facturación MCP server

Emite CFDIs 4.0 y resuelve claves del SAT para agentes de IA (México), con permisos por API key.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-heusai-notsy-facturacion
- Website: https://facturacion.notsy.com.mx/developers

## Install
- Endpoint: https://mcp.notsy.com.mx/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Remote header: Authorization (required; secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://mcp.notsy.com.mx/mcp
- Header: Authorization

## Tools
- whoami - Confirma la identidad del agente: a qué negocio pertenece la API key, sus permisos
    (scopes), límites de emisión y uso del día. Úsalo para diagnosticar la conexión. Endpoint: https://mcp.notsy.com.mx/mcp
- resolver_claves_sat - Convierte una descripción en lenguaje natural a las claves del SAT necesarias para facturar.

    Devuelve `sugerencia` con clave_prodserv, clave_unidad, objeto_imp, tasa_iva y uso_cfdi, más
    `candidatos` por si quieres elegir otra. Llámalo antes de armar un concepto si no conoces las claves.

    Args:
        descripcion: qué se vende, p.ej. "consultoría de marketing" o "laptop Dell".
        unidad_hint: opcional, unidad de medida en palabras ("servicio", "hora", "pieza", "kg").
        con_iva: si el producto/servicio causa IVA 16% (default True).
     Endpoint: https://mcp.notsy.com.mx/mcp
- preview_factura - DRY-RUN: valida la factura y calcula los totales (subtotal, IVA, retenciones, total) SIN
    timbrar y sin costo. Úsalo SIEMPRE antes de emitir_cfdi para confirmar el monto y que los datos
    pasen la validación.

    Args:
        conceptos: lista de conceptos. Cada uno: {descripcion, clave_prodserv, clave_unidad,
            cantidad, valor_unitario, precio_incluye_iva (bool), tasa_iva (0.16/0.08/0.0),
            objeto_imp ("02"), retencion ("honorarios"|"arrendamiento"|"comisiones"|"fletes"|"")}.
        cliente: datos del receptor {rfc, nombre, regimen_fiscal, cp, uso_cfdi, email,
            es_publico_general} — o usa cliente_id si ya está guardado.
        cliente_id: id de un cliente guardado (alternativa a `cliente`).
        forma_pago: clave SAT de forma de pago (default "03" transferencia).
        metodo_pago: "PUE" (de contado) o "PPD" (a crédito).
        emisor_id: opcional, desde qué RFC emitir (multiemisor); None = predeterminado.
     Endpoint: https://mcp.notsy.com.mx/mcp
- emitir_cfdi - Emite y timbra un CFDI 4.0 OFICIAL ante el SAT (acción real, con costo y difícil de revertir).
    Llama primero a preview_factura. El motor aplica los límites de la API key (puede requerir
    aprobación humana) y registra la acción en la bitácora.

    Args: iguales a preview_factura, más:
        observaciones: texto libre opcional en el CFDI.
        anticipo_id: opcional, id de un anticipo previo a aplicar (relación 07 + nota de crédito).
        idempotency_key: OBLIGATORIA en producción (genera un UUID por operación y reúsalo en
            los reintentos). Si reintentas con la misma clave, NO se timbra de nuevo: se
            devuelve el resultado original (evita CFDIs duplicados ante el SAT).
     Endpoint: https://mcp.notsy.com.mx/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.HEUSAI
- Version: 1.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jun 8, 2026
- Source: https://registry.modelcontextprotocol.io