Auditor DIAN
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AUDITOR_DIAN_HOME | No | Carpeta donde viven las bases de datos de los clientes. Por defecto es `~/.auditor-dian/`. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Carga y consulta las facturas electrónicas DIAN que recibió cada cliente. Para cargar: crear_cliente (una vez) e ingerir_facturas con la ruta de un ZIP, XML o carpeta; si la carpeta trae facturas de varios clientes, o el usuario no dice dónde están, ingerir_por_cliente las reparte (sin ruta revisa Descargas). Para saber si un cliente ya está registrado: listar_clientes con buscar; historial_cliente dice qué meses tiene cargados. Si algo falla o una cifra no cuadra, diagnostico resume el estado para reportarlo. Las cifras ya vienen calculadas: cítelas tal cual con sus CUFE, sin sumarlas ni redondearlas. Los montos son texto decimal exacto en la moneda de cada documento. Fechas en formato AAAA-MM-DD; los rangos son inclusivos y por fecha de emisión. El usuario puede no tener conocimientos técnicos: pídale la carpeta por su nombre (por ejemplo 'facturas-enero, en Descargas'), no una ruta; pase el NIT o la cédula tal como lo escribió, el servidor lo interpreta; responda en lenguaje sencillo, sin mencionar herramientas, JSON ni códigos internos salvo que lo pida. Diga siempre al usuario: Cifras calculadas a partir de los documentos cargados. Requiere revisión del contador.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| listar_clientesA | Lista los clientes registrados en este equipo (NIT o cédula y nombre), o busca uno. Úsela cuando el usuario pregunte, por ejemplo:
Para ver qué meses tiene cargados un cliente use historial_cliente. |
| historial_clienteA | Ficha de un cliente registrado: nombre, fecha de registro, cuántos documentos tiene por tipo y por mes de emisión, primera y última fecha de emisión, y cada día en que se cargaron facturas con sus archivos, documentos y errores. Úsela cuando el usuario pregunte, por ejemplo:
No trae montos: para cifras use resumen_periodo. |
| buscar_documentosA | Busca facturas y notas que recibió el cliente, combinando filtros: proveedor, fechas, valor, tipo de documento, CUFE o medio de pago. Úsela cuando el usuario pida documentos puntuales, por ejemplo:
No la use para totales de IVA, compras o retenciones (use resumen_periodo): aquí no se suma. Devuelve hasta 200 documentos y cuántos coinciden en total; si son más, pida acotar. |
| resumen_periodoA | Totales del periodo con los CUFE que los respaldan: compras (total y por tipo de documento), IVA (total y por tarifa) y retenciones por tipo. Las notas crédito y de ajuste restan. Úsela cuando el usuario pregunte cifras, por ejemplo:
Es el IVA que figura en los documentos, no una determinación de IVA descontable. Las retenciones de facturas y documentos soporte son autorretenciones que declara el emisor (Anexo FE 1.9, FAT01): no diga que se las practicaron al cliente ni que el cliente las practicó. Cite las cifras tal cual vienen, sin sumarlas ni redondearlas. |
| facturas_creditoA | Facturas recibidas con forma de pago a crédito en el periodo, con proveedor, valor y vencimiento. Úsela cuando el usuario pregunte, por ejemplo:
Los eventos (acuse, aceptación, endoso) quedan "por verificar": este servidor no consulta a la DIAN. |
| duplicados_y_anulacionesA | Facturas del mismo proveedor y número con distinto CUFE (posibles duplicados) y facturas anuladas total o parcialmente por notas crédito (tolerancia de 2 pesos). Úsela cuando el usuario pregunte, por ejemplo:
|
| exportar_informeA | Guarda un informe del periodo en un Excel nuevo, con una hoja de resumen y otra de detalle con los CUFE. Úsela cuando el usuario pida, por ejemplo:
Nunca sobrescribe: si el archivo ya existe, proponga otro nombre. Devuelve dónde quedó. |
| crear_clienteA | Registra un cliente nuevo en este equipo para poder cargar y consultar sus facturas. Úsela cuando el usuario diga, por ejemplo:
Si el cliente ya existe no cambia nada y devuelve su historial ( |
| ingerir_facturasA | Carga en un cliente las facturas electrónicas de un ZIP o XML (como llegan por correo) o de una carpeta completa. Úsela cuando el usuario diga a qué cliente van, por ejemplo:
Si no dice de qué cliente son, o la carpeta trae facturas de varios clientes, use ingerir_por_cliente. Solo agrega: lo ya cargado se salta y nada se duplica. Devuelve cuántos archivos y documentos entraron y los errores de lectura. |
| ingerir_por_clienteA | Carga facturas de varios clientes a la vez: cada archivo va al cliente que aparece como comprador en la factura. Úsela cuando el usuario diga, por ejemplo:
Solo carga en clientes ya registrados. |
| diagnosticoA | Estado de la instalación para reportar un problema: versión, carpeta de datos, plugins y, por cliente, documentos, archivos cargados, última carga y advertencias de lectura (las últimas 20). No incluye montos ni contenido de las facturas, así que se puede compartir. Úsela cuando el usuario diga, por ejemplo:
Explique en palabras sencillas lo que encuentre y, si hay que reportarlo, entréguele el resultado completo para que lo copie. |
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 11 tools
Descriptions actively cross-reference each other (listar_clientes → historial_cliente → resumen_periodo; ingerir_facturas ↔ ingerir_por_cliente), making boundaries unusually clear. Minor residual overlap: facturas_credito partly duplicates buscar_documentos' payment-method/CUFE filtering, and buscar_documentos vs resumen_periodo could still be confused by an inattentive agent, though both are explicitly disclaimed.
Half the tools use a verb_noun pattern (listar_clientes, buscar_documentos, crear_cliente, ingerir_facturas, exportar_informe) while the other half are bare nouns (historial_cliente, resumen_periodo, diagnostico, facturas_credito, duplicados_y_anulaciones). All names are readable and domain-meaningful, but the convention is genuinely mixed rather than uniform.
Eleven tools for a Colombian e-invoicing audit domain is well within the 3-15 sweet spot, and each maps to a distinct user intent (list, inspect, search, total, diagnose, credit, dedupe, export, create client, ingest two ways). No obvious filler or redundant tool.
Covers the full read/ingest/export lifecycle including client creation, batch ingestion with unregistered-buyer resolution, period totals, and duplicate/annulment checking. Notable gap: there is no way to delete, re-load, or correct an already-ingested document or client — a real dead end when ingestion goes wrong — and no single-document detail view beyond search results.