@timbrix/mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | HTTP transport port when MCP_TRANSPORT=http. | 8787 |
| MCP_HTTP_HOST | No | HTTP transport bind address. Default is 127.0.0.1 (loopback only). | 127.0.0.1 |
| MCP_TRANSPORT | No | Transport mode: stdio (default, for local agents) or http (for hosted use). | stdio |
| TIMBRIX_API_KEY | No | API key created in the Timbrix dashboard, scoped to one organization. Required only for stdio transport (default). | |
| TIMBRIX_API_URL | No | Overrides the API base URL. | https://api.timbrix.mx |
| MCP_ALLOWED_HOSTS | No | Comma-separated hostnames this server is publicly reachable as (Host-header allowlist). Required only when MCP_HTTP_HOST is non-loopback. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| timbrix_crear_cfdi_ingresoA | Timbra (sella ante el SAT vía PAC) un CFDI 4.0 de tipo Ingreso para la organización configurada. Devuelve el UUID fiscal, el XML timbrado y el estatus. |
| timbrix_cancelar_cfdiA | Solicita la cancelación de un CFDI ya timbrado ante el SAT. Si el receptor debe aprobar la cancelación, el resultado queda en estatus 'pendiente'. |
| timbrix_listar_cfdiA | Lista los CFDI timbrados de la organización configurada, más recientes primero, con filtros opcionales de tipo y estatus. |
| timbrix_consultar_saldoA | Devuelve cuántos CFDI ha timbrado la organización configurada en el mes calendario actual (hora Ciudad de México) contra el límite incluido en su plan, y cuándo se reinicia el periodo. Importante: |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Cada herramienta cubre una acción distinta: timbrar, cancelar, listar y consultar saldo. No hay solapamiento real entre ellas; incluso listar y consultar saldo se diferencian claramente porque uno devuelve documentos y el otro uso mensual del plan.
Las cuatro herramientas siguen el patrón consistente timbrix_ + verbo en infinitivo + objeto: crear_cfdi_ingreso, cancelar_cfdi, listar_cfdi, consultar_saldo. La variante con subtipo en crear_cfdi_ingreso es descriptiva y no rompe la convención.
Cuatro herramientas es una cantidad adecuada para un servicio especializado de timbrado fiscal: cubre las operaciones esenciales sin inflar la superficie. No hay herramientas redundantes ni faltan piezas obvias dentro del alcance declarado.
El ciclo principal queda cubierto: crear/timbrar, cancelar, listar y monitorear saldo. Faltan detalles menores como consultar un CFDI específico por UUID o descargar el XML de uno ya timbrado, pero no son huecos que impidan el flujo de trabajo central.