protogrid

Search / io.github.HEUSAI/notsy-facturacion

Notsy Facturación

R1· needs a key

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

v1.0.0 · active · website · descriptor JSON · versions

An agent can connect on its own if it already holds NOTSY_FACTURACION_TOKEN.Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.
Quality80good
Trust73of 100
Uptime, 30 days100%
Latency p50247 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "notsy-facturacion": {
      "type": "http",
      "url": "https://mcp.notsy.com.mx/mcp",
      "headers": {
        "Authorization": "Bearer ${NOTSY_FACTURACION_TOKEN}"
      }
    }
  }
}
claude mcp add --transport http notsy-facturacion https://mcp.notsy.com.mx/mcp --header "Authorization: Bearer ${NOTSY_FACTURACION_TOKEN}"
[mcp_servers.notsy-facturacion]
url = "https://mcp.notsy.com.mx/mcp"
bearer_token_env_var = "NOTSY_FACTURACION_TOKEN"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "notsy-facturacion": {
      "type": "remote",
      "url": "https://mcp.notsy.com.mx/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:NOTSY_FACTURACION_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "notsy-facturacion": {
      "type": "http",
      "url": "https://mcp.notsy.com.mx/mcp",
      "headers": {
        "Authorization": "Bearer ${NOTSY_FACTURACION_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=notsy-facturacion&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLm5vdHN5LmNvbS5teC9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgJHtOT1RTWV9GQUNUVVJBQ0lPTl9UT0tFTn0ifX0%3D"
}
{
  "servers": {
    "notsy-facturacion": {
      "type": "http",
      "url": "https://mcp.notsy.com.mx/mcp",
      "headers": {
        "Authorization": "Bearer ${NOTSY_FACTURACION_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "notsy-facturacion": {
      "httpUrl": "https://mcp.notsy.com.mx/mcp",
      "headers": {
        "Authorization": "Bearer ${NOTSY_FACTURACION_TOKEN}"
      }
    }
  }
}
extensions:
  "notsy-facturacion":
    enabled: true
    name: "notsy-facturacion"
    type: streamable_http
    uri: "https://mcp.notsy.com.mx/mcp"
    headers:
      "Authorization": "Bearer ${NOTSY_FACTURACION_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${NOTSY_FACTURACION_TOKEN}. The registry never accepts secret values.

Quality 80 / 100good

protocol88 · weight 25
  • pass
    protocol.modernsupports 2026-07-28 (server/discover)
  • pass
    protocol.statelessanswers without a session
  • pass
    protocol.transportstreamable HTTP
  • warn
    protocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every use
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene64 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • warn
    tools.description_length1 tools have descriptions over 1,024 characters, which crowds the context
  • pass
    tools.schemasevery tool has an object input schema
  • fail
    tools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
  • fail
    tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: resolver_claves_sat (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); preview_factura (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); emitir_cfdi (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
  • pass
    tools.token_costabout 1,224 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changes1 tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

4 tools, about 1,224 tokens to load them all · tool set 758ee90281ea · tools last changed 2026-10-02 · checked 2026-10-20 22:55 UTC

Tool changes

  • emitir_cfdichangeddescription
    before

    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).

    after · 75% of words in common

    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 o el estado de verificación. Con 504 PAC_SIN_CONFIRMACION o 409 CFDI_EN_VERIFICACION, reintenta más tarde con la MISMA clave y nunca con otra; 409 OPERACION_CERRADA pide una clave nueva; 409 CFDI_YA_EMITIDO significa que ya existe.

Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 73 / 100

no-repository
provenance45
liveness100
freshness65
hygiene80

+website +reachable +uptime-100% ~updated-134d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://mcp.notsy.com.mx/mcp streamable-httpapi_key ${NOTSY_FACTURACION_TOKEN}yes100%247 ms2026-07-282026-10-20

Tools (4)

emitir_cfdiEmite 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 o el estado de verificación. Con 504 PAC_SIN_CONFIRMACION o 409 CFDI_EN_VERIFICACION, reintenta más tarde con la MISMA clave y nunca con otra; 409 OPERACION_CERRADA pide una clave nueva; 409 CFDI_YA_EMITIDO significa que ya existe.
preview_facturaDRY-RUN: valida la factura y calcula los totales (subtotal, IVA, retenciones, total) SIN timbrar, reservar ni cobrar. También devuelve la cotización canónica de créditos y el saldo proyectado. Úsalo SIEMPRE antes de emitir_cfdi para confirmar el monto, el costo y que los datos pasen la validación. Aplicar un anticipo cotiza dos CFDI (ingreso + egreso). 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. anticipo_id: opcional, anticipo previo a aplicar; cotiza dos CFDI.
resolver_claves_satConvierte 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).
whoamiConfirma 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.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "io.github.HEUSAI/notsy-facturacion",
  "title": "Notsy Facturación",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://mcp.notsy.com.mx/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "isRequired": true,
          "description": "API key del negocio en formato 'Bearer ntsy_...', generada en https://facturacion.notsy.com.mx"
        }
      ]
    }
  ],
  "version": "1.0.0",
  "websiteUrl": "https://facturacion.notsy.com.mx/developers",
  "description": "Emite CFDIs 4.0 y resuelve claves del SAT para agentes de IA (México), con permisos por API key."
}