Skip to main content
Glama
API Colombia

API Colombia

by TernApp

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)

  1. Entra a la ficha de la API en RapidAPI y suscríbete al plan Basic.

  2. 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-colombia

Remoto:

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 entorno RAPIDAPI_KEY.

  • Remoto: la URL es https://mcp.rumbi.io/mcp (Streamable HTTP). Envía la llave en la cabecera X-RapidAPI-Key o como Authorization: Bearer TU_LLAVE.

Herramientas

Herramienta

Qué hace

vencimientos_dian

Próximos vencimientos de un NIT, ordenados por fecha y con los días que faltan

calendario_dian

Calendario tributario del año (2025–2035) para las obligaciones que pidas

obligaciones_dian

Las 18 obligaciones soportadas, de qué dígitos del NIT dependen y su base legal

sumar_dias_habiles

Fecha que resulta de sumar o restar N días hábiles

contar_dias_habiles

Días hábiles entre dos fechas

es_dia_habil

Si una fecha es hábil y, si no lo es, por qué

festivos

Festivos de un año, indicando cuáles se trasladan al lunes

es_festivo

Si una fecha es festivo y cuál

indicadores

UVT, salario mínimo y auxilio de transporte de un año

convertir_uvt

Conversión de UVT a pesos o de pesos a UVT

trm

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.io solo 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-colombia with RAPIDAPI_KEY.

  • Remote: https://mcp.rumbi.io/mcp with the X-RapidAPI-Key header.

Tool descriptions are in Spanish, and assistants use them in any language.

Licencia MIT.

Available Tools

11 tools
calendario_dianCalendario tributario DIAN del añoA
Read-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 fechasA
Read-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 ↔ pesosA
Read-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?B
Read-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?B
Read-onlyIdempotent

Indica si una fecha es festivo en Colombia y cuál.

Inputs: fecha.

festivosFestivos de ColombiaA
Read-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 transporteA
Read-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 soportadasA
Read-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ábilesA
Read-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)B
Read-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 NITA
Read-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

    A3.7/5.0

    Scored across 11 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Lets 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
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      4
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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