API Colombia
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| RAPIDAPI_KEY | No | Tu llave X-RapidAPI-Key (plan Basic gratis, 500 consultas/mes). Se usa en el modo local (npx -y mcp-api-colombia) como variable de entorno. Tu llave es privada: no la publiques ni la subas a repositorios. | |
| X-RapidAPI-Key | No | Tu llave de RapidAPI, enviada como cabecera X-RapidAPI-Key al servidor remoto https://mcp.rumbi.io/mcp (Streamable HTTP). Alternativamente puede enviarse como Authorization: Bearer TU_LLAVE. Tu llave es privada: no la publiques ni la subas a repositorios. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Datos oficiales de fechas en Colombia: festivos, días hábiles, vencimientos tributarios de la DIAN por NIT, UVT, salario mínimo y TRM. Las fechas van en formato AAAA-MM-DD. Los días hábiles se cuentan desde el día siguiente a la fecha inicial, como en los términos legales. El calendario DIAN cubre obligaciones nacionales; no incluye información exógena, impuestos municipales (ICA) ni ampliaciones regionales de plazo.
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 |
|---|---|
| vencimientos_dianA | Devuelve los próximos vencimientos tributarios nacionales de la DIAN (Colombia) para un NIT o cédula, ordenados por fecha y con los días que faltan. Úsala cuando pregunten "¿qué le vence a este NIT?", "¿cuándo debo declarar renta?" o "¿cuándo vence la retención/IVA?". Colombian DIAN tax deadlines by taxpayer ID. |
| calendario_dianA | Calendario tributario nacional de la DIAN para un año: fechas de cada obligación según el último dígito (o los dos últimos, en renta de personas naturales) del NIT. Pide solo las obligaciones necesarias: la respuesta completa es larga. |
| obligaciones_dianA | Lista las 18 obligaciones tributarias nacionales soportadas, de qué dígitos del NIT dependen y su base legal. |
| sumar_dias_habilesA | Calcula la fecha que resulta de sumar (o restar, con números negativos) días hábiles en Colombia, saltando fines de semana y festivos. El conteo empieza el día siguiente a la fecha inicial. Úsala para plazos legales, entregas o "¿qué fecha es N días hábiles después de…?". |
| contar_dias_habilesA | Cuenta los días hábiles en Colombia desde el día siguiente a "desde" hasta "hasta" inclusive, e indica cuántos días fueron festivos y fines de semana. |
| es_dia_habilB | Indica si una fecha es día hábil en Colombia y, si no lo es, por qué (sábado, domingo o festivo). |
| festivosA | Lista los festivos oficiales de Colombia de un año (1984–2100), con la fecha original y si se trasladaron al lunes. Desde 2026 son 19, por la Ley 2578 de 2026 (Virgen de Chiquinquirá). |
| es_festivoB | Indica si una fecha es festivo en Colombia y cuál. |
| indicadoresA | Valor de la UVT, el salario mínimo (SMMLV) y el auxilio de transporte en Colombia para un año (2019 en adelante). |
| convertir_uvtA | Convierte UVT a pesos colombianos o pesos a UVT con el valor del año. Envía exactamente uno: "uvt" o "pesos". |
| trmB | Tasa Representativa del Mercado (pesos por dólar) vigente en una fecha, según la Superintendencia Financiera. |
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
The three DIAN tools (vencimientos_dian, calendario_dian, obligaciones_dian) share a domain but are separated by output shape: personalized upcoming deadlines, full-year calendar by NIT digit, and a static list of obligations. The date utilities (sumar_dias_habiles, contar_dias_habiles, es_dia_habil, es_festivo, festivos) are also clearly differentiated by their descriptions, though a careless agent could still pick calendario_dian when vencimientos_dian was intended.
All names are snake_case Spanish and readable, with a coherent sub-pattern of 'es_' predicates for boolean checks and verb-first names for computations. The only inconsistency is mixing noun-phrase names (festivos, indicadores, trm, calendario_dian) with verb-phrase names, which is a minor deviation rather than a real problem.
Eleven tools is well within the sweet spot and each one maps to a distinct, reusable capability (tax deadlines, business-day math, holidays, economic indicators, FX rate). Nothing feels padded or redundant.
The surface covers the stated Colombian fiscal/calendar domain end to end: deadlines, obligations, holiday calendar, business-day arithmetic, UVT/SMMLV indicators, UVT conversion, and TRM. Minor gaps exist, such as no reverse lookup from a date to which obligations fall due, or a NIT check-digit helper, but agents can work around these with the existing tools.