API Colombia
Routes Colombian DIAN tax deadlines, business-day calculations, holidays, UVT indicators, and TRM exchange-rate queries through RapidAPI using the user's X-RapidAPI-Key.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@API Colombia ¿Qué le vence en diciembre al NIT 900123456-8 con IVA bimestral?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
API Colombia: servidor MCP
Le da a tu asistente de IA (Claude, Cursor, VS Code, etc.) datos oficiales de fechas en Colombia:
Vencimientos tributarios de la DIAN por NIT: retención en la fuente, IVA, renta, SIMPLE, patrimonio y 18 obligaciones nacionales en total. El calendario sigue el Decreto 2229 de 2023 y el día cívico del Decreto 500 de 2024.
Días hábiles: sumar, restar, contar o comprobar una fecha. Excluye festivos y fines de semana, y permite contar el sábado como hábil si lo indicas.
Festivos de Colombia de 1984 a 2100. Desde 2026 son 19, por la Ley 2578 de 2026.
Indicadores: UVT, salario mínimo, auxilio de transporte y conversión entre UVT y pesos.
TRM de cualquier fecha, con datos de la Superintendencia Financiera publicados en datos.gov.co.
Pregúntale a tu asistente cosas como:
¿Qué le vence en diciembre al NIT 900123456-8? Es responsable de IVA bimestral y retención en la fuente.
Si me notifican el 13 de noviembre de 2026, ¿cuándo se cumplen 10 días hábiles?
¿Cuántos días hábiles hay entre el 1 y el 31 de diciembre de 2026?
Las consultas pasan por RapidAPI con tu propia llave. El plan Basic es gratis e incluye 500 consultas al mes.
1. Consigue tu llave (gratis)
Entra a la ficha de la API en RapidAPI y suscríbete al plan Basic.
Copia tu X-RapidAPI-Key, que aparece en los ejemplos de código de la ficha.
Tu llave es privada: no la publiques ni la subas a repositorios.
Related MCP server: mcp-trm-colombia
2. Conéctalo a tu asistente
Hay dos formas. La local (con npx) necesita Node.js 20 o superior en tu computador. La remota no necesita instalar nada.
Claude Desktop
En Configuración → Desarrollador → Editar configuración (claude_desktop_config.json), agrega:
{
"mcpServers": {
"api-colombia": {
"command": "npx",
"args": ["-y", "mcp-api-colombia"],
"env": { "RAPIDAPI_KEY": "TU_LLAVE" }
}
}
}Reinicia Claude Desktop.
Claude Code
Local:
claude mcp add --env RAPIDAPI_KEY=TU_LLAVE --transport stdio api-colombia -- npx -y mcp-api-colombiaRemoto:
claude mcp add --transport http api-colombia https://mcp.rumbi.io/mcp --header "X-RapidAPI-Key: TU_LLAVE"Cursor
En ~/.cursor/mcp.json, usa una de las dos entradas:
{
"mcpServers": {
"api-colombia": {
"command": "npx",
"args": ["-y", "mcp-api-colombia"],
"env": { "RAPIDAPI_KEY": "TU_LLAVE" }
},
"api-colombia-remoto": {
"url": "https://mcp.rumbi.io/mcp",
"headers": { "X-RapidAPI-Key": "TU_LLAVE" }
}
}
}VS Code (GitHub Copilot)
En .vscode/mcp.json, VS Code te pide la llave la primera vez y la guarda cifrada:
{
"inputs": [
{ "type": "promptString", "id": "rapidapi-key", "description": "X-RapidAPI-Key", "password": true }
],
"servers": {
"api-colombia": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-api-colombia"],
"env": { "RAPIDAPI_KEY": "${input:rapidapi-key}" }
}
}
}Para usar el servidor remoto, cambia la entrada por:
"api-colombia": { "type": "http", "url": "https://mcp.rumbi.io/mcp", "headers": { "X-RapidAPI-Key": "${input:rapidapi-key}" } }Otros clientes
Local: el comando es
npx -y mcp-api-colombia, con la variable de entornoRAPIDAPI_KEY.Remoto: la URL es
https://mcp.rumbi.io/mcp(Streamable HTTP). Envía la llave en la cabeceraX-RapidAPI-Keyo comoAuthorization: Bearer TU_LLAVE.
Herramientas
Herramienta | Qué hace |
| Próximos vencimientos de un NIT, ordenados por fecha y con los días que faltan |
| Calendario tributario del año (2025–2035) para las obligaciones que pidas |
| Las 18 obligaciones soportadas, de qué dígitos del NIT dependen y su base legal |
| Fecha que resulta de sumar o restar N días hábiles |
| Días hábiles entre dos fechas |
| Si una fecha es hábil y, si no lo es, por qué |
| Festivos de un año, indicando cuáles se trasladan al lunes |
| Si una fecha es festivo y cuál |
| UVT, salario mínimo y auxilio de transporte de un año |
| Conversión de UVT a pesos o de pesos a UVT |
| TRM vigente en una fecha |
Todas son de solo lectura. 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.
Alcance: el calendario DIAN cubre obligaciones nacionales. No incluye información exógena, impuestos municipales (ICA) ni ampliaciones de plazo para regiones específicas. Verifica siempre las fechas críticas en dian.gov.co.
Privacidad
El servidor no guarda tu llave ni la escribe en sus registros.
Cada consulta viaja a RapidAPI, que registra las peticiones (incluido el NIT consultado) como en cualquier uso de su plataforma.
En el modo remoto,
mcp.rumbi.iosolo reenvía la consulta.
Desarrollo
npm install
npm test # pruebas de punta a punta (necesitan ../api-colombia al lado)
RAPIDAPI_KEY=... npm start # modo local (stdio)
PORT=3102 npm run start:http # modo remoto (http://127.0.0.1:3102/mcp)In English
MCP server for Colombian business days, public holidays (19 from 2026), DIAN tax deadlines by taxpayer ID (NIT), UVT and the official USD/COP rate (TRM). Calls are routed through RapidAPI with your own key, and the free Basic plan includes 500 requests per month.
Local:
npx -y mcp-api-colombiawithRAPIDAPI_KEY.Remote:
https://mcp.rumbi.io/mcpwith theX-RapidAPI-Keyheader.
Tool descriptions are in Spanish, and assistants use them in any language.
Licencia MIT.
Available Tools
11 toolscalendario_dianCalendario tributario DIAN del añoARead-onlyIdempotent
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.
Inputs: obligaciones (required), anio.
contar_dias_habilesContar días hábiles entre dos fechasARead-onlyIdempotent
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.
Inputs: desde (required), hasta (required), sabado_habil.
convertir_uvtConvertir UVT ↔ pesosARead-onlyIdempotent
Convierte UVT a pesos colombianos o pesos a UVT con el valor del año. Envía exactamente uno: "uvt" o "pesos".
Inputs: uvt, anio, pesos.
es_dia_habil¿Es día hábil?BRead-onlyIdempotent
Indica si una fecha es día hábil en Colombia y, si no lo es, por qué (sábado, domingo o festivo).
Inputs: fecha, sabado_habil.
es_festivo¿Es festivo?BRead-onlyIdempotent
Indica si una fecha es festivo en Colombia y cuál.
Inputs: fecha.
festivosFestivos de ColombiaARead-onlyIdempotent
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á).
Inputs: anio.
indicadoresUVT, salario mínimo y auxilio de transporteARead-onlyIdempotent
Valor de la UVT, el salario mínimo (SMMLV) y el auxilio de transporte en Colombia para un año (2019 en adelante).
Inputs: anio.
obligaciones_dianObligaciones DIAN soportadasARead-onlyIdempotent
Lista las 18 obligaciones tributarias nacionales soportadas, de qué dígitos del NIT dependen y su base legal.
Inputs: no named parameters.
sumar_dias_habilesSumar o restar días hábilesARead-onlyIdempotent
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…?".
Inputs: dias (required), fecha, sabado_habil.
trmTRM (dólar oficial en Colombia)BRead-onlyIdempotent
Tasa Representativa del Mercado (pesos por dólar) vigente en una fecha, según la Superintendencia Financiera.
Inputs: fecha.
vencimientos_dianPróximos vencimientos DIAN de un NITARead-onlyIdempotent
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.
Inputs: nit (required), obligaciones (required), dias, desde.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
Time and date math for AI agents: Unix timestamp conversion, DST-correct time zone conversion, durations, epoch arithmetic, cron schedules, and holiday countdowns. Eight tools, no key.
Date/time math for agents: business days, holidays, time zones, cron, RRULE. 25 free calls/day.
Reliable Australian business-day, public-holiday and deadline tools for AI agents.
Current time, timezone conversion & date math for AI agents. On Cloudflare Workers.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceLets AI agents issue and query Colombia DIAN electronic invoices (factura electrónica) via the Matias API, handling IVA math locally and forwarding requests to Matias for signing and DIAN transmission.MIT
- AlicenseAqualityCmaintenanceEnables LLMs to retrieve the official Colombian TRM (USD/COP exchange rate) with its validity window, perform currency conversions, and analyze rate series, all with auditable provenance.4MIT
- AlicenseAqualityCmaintenanceEnables querying Colombia's official TRM (USD/COP) exchange rate for any date, retrieving historical ranges with statistics, and converting between USD and COP at official rates.3MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to query upcoming Indian statutory obligations, inspect individual rules and their penalty exposure, search filings, derive downstream deadlines from corporate events, check dates against holidays, and read regulator updates. It reads the published calendar data, with the data source configurable via an environment variable.MIT