normativa-colombia-mcp

Consulta la normativa y la jurisprudencia colombiana desde cualquier asistente de IA que hableModel Context Protocol, sin abrir el navegador ni pelear con formularios.

La más sencilla si usas Claude Desktop: no requiere Node ni tocar archivos de configuración.
- Descarganormativa-colombia.mcpbdesdeReleases.
- Abre Claude Desktop →Configuración → Extensiones.
- Arrastra el archivo a esa ventana y confirma.

Publicado comonormativa-colombia-mcp. RequiereNode 18 o superior. No hay que clonar ni compilar nada: el paquete trae el servidor ya construido y el índice temático dentro, y no arrastra ninguna dependencia.

# sin instalar nada, la forma habitual en clientes MCP npx -y normativa-colombia-mcp # o instalado en el proyecto npm install normativa-colombia-mcp # o disponible en todo el sistema npm install -g normativa-colombia-mcp

{ "mcpServers": { "normativa-colombia": { "command": "npx", "args": ["-y", "normativa-colombia-mcp"] } } }

Claude Codeno usa archivo; se registra por línea de comandos:

claude mcp add normativa-colombia -- npx -y normativa-colombia-mcp

VS Codeusa la claveserversen vez demcpServers, en.mcp.jsondel proyecto o en la configuración de usuario:

{ "servers": { "normativa-colombia": { "type": "stdio", "command": "npx", "args": ["-y", "normativa-colombia-mcp"] } } }

Si lo instalaste connpm install -g, el comando esnormativa-colombia-mcpa secas, sin argumentos.

Si tu cliente no está en la lista, busca dónde declara servidores MCP por stdio: el comando y los argumentos son siempre los mismos.

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"prueba","version":"1"}}}' \ | npx -y normativa-colombia-mcp

Debe responder un JSON con"name":"normativa-colombia"y un campoinstructions.

Para desarrollar o para fijar una versión propia. RequiereNode 22 o superior:

git clone https://github.com/Angelthebestone/Normativa-colombiana-MCP.git cd Normativa-colombiana-MCP npm install npm run generar-indice # índice temático, ~20 MB de descarga, una sola vez npm run build # genera server/index.js

Después se apunta el cliente anode /ruta/absoluta/a/Normativa-colombiana-MCP/server/index.js, con el mismo formato de arriba. Funciona desde cualquier directorio de trabajo.

Al conectarse, el servidor entrega26 herramientas,5 promptsy suspropias instrucciones de uso: a qué tipo de pregunta corresponde cada herramienta, que debe citarse siempre la fuente y que nunca debe afirmarse por cuenta propia que una norma está vigente. Los clientes que respetan el campoinstructionsdel protocolo lo aprovechan sin configurar nada.

- «¿Qué dice la Ley 1221 de 2008 sobre el auxilio de conectividad?»
- «¿Qué normas regulan el teletrabajo en el sector público y por qué aplican?»
- «¿Qué dice el Decreto 1083 sobre encargos?»
- «Búscame jurisprudencia reciente de la Corte Constitucional sobre estabilidad laboral reforzada.»
- «¿La Ley 909 de 2004 sigue vigente?»
- «¿Qué dice la DIAN sobre la retención en la fuente por servicios?»
- «Búscame tutelas de la Corte Suprema sobre teletrabajo y dime qué normas citan.»
- «¿Existe la Ley 74 de 1923 y sigue vigente?» — está derogada, y ni el Gestor la tiene.
- «¿Qué leyes hay sobre teletrabajo?» —consultar_por_jerarquiacon nivel "ley".
- «Compara el art. 2 de la Ley 909 con el art. 2.2.5.3.1 del Decreto 1083.» —comparar_articulos.
- «¿Hay conflicto entre la Ley 909 de 2004 y el Decreto 1083 de 2015 en materia de encargos?» —analizar_conflicto(reúne evidencia, no concluye).
- «¿Qué cambió la Ley 909 de 2004 desde 2020?» —cambios_desde.
- «Normativa laboral sobre teletrabajo» —consultar_perfilcon perfil "laboral".

El servidor incluye además cinco prompts listos, que los clientes que los soportan muestran como comandos:¿Qué normas aplican sobre un tema?,¿Esta norma sigue vigente?,Explícame esta norma en lenguaje sencillo,Compara dos normasyAclarar una consulta ambigua.

Sobre la capa común de metadatos, evidencia y normalización:

- consultar_por_jerarquiafiltra por nivel (constitución, ley, decreto, resolución, concepto, jurisprudencia) y explica el carácter de cada uno. El Gestor no cataloga la Constitución como tipo: para ese nivel se orienta.
- resolver_citaconvalidar: truecomprueba que una cita y su enlace son de verdad: número/año contra el título, dominio del enlace, id de la norma y existencia del artículo. Clasifica en "validada", "parcialmente validada" o "no fue posible validar"; nunca afirma vigencia.
- analizar_conflictoreúne EVIDENCIA de un posible conflicto entre dos normas (identificación, vigencia según SUIN si consta, jerarquía, reformas anotadas, pasajes sobre un tema).No detecta contradicciones semánticasy el resultado es un conflicto POTENCIAL, no una conclusión jurídica.
- cambios_desderesume los cambios (modificación, derogación, adición) que el Gestor anota sobrelas normas que se le listan, filtrados por el año de la norma modificadora.No rastrea novedadespor su cuenta.
- comparar_articuloscompara el texto de un artículo entre dos normas, marca lo añadido/eliminado, clasifica cada diferencia por patrones (plazo, sanción, excepción, sujeto obligado) y agrupa los cambios editoriales por similitud léxica (Dice sobre bigramas ≥0,92): «una línea» → «una sola línea» sale como cambio menor, no como añadido+eliminado. Lo no clasificado se marca "revisar manualmente". Sin modelo semántico.
- consultar_perfilejecuta una consulta con las fuentes y filtros preconfigurados de un perfil:laboral,tributario,ambiental,contratacion_estatal,energia. Cada perfil declara su advertencia en la respuesta.
- expedienteconaccion="crear|agregar|leer|exportar"agrupa consultas, citas y observaciones de una investigación.Desactivado por defecto: se activa con la variable de entornoEXPEDIENTES=1; la persistencia en disco, conEXPEDIENTES_DIR.

Una regla de oro de las V2: si una cita viene sin año y el número es ambiguo ("Decreto 1072" son cuatro), la herramientano elige por ti: lista los candidatos y pide el año.

Lo que debes saber antes de confiar en una respuesta

Esto no es asesoría jurídica.Es un buscador que le da a un asistente de IA acceso a fuentes oficiales. Verifica siempre en el enlace que acompaña cada respuesta.

La vigencia viene de SUIN, y solo de SUIN.Ni el Gestor ni la relatoría tienen un campo que diga «esta norma está derogada»: las derogatorias van escritas dentro del texto, y el servidor se limita a avisar cuando detecta marcas de «Derogado» o «Modificado por» (el Decreto 1083 de 2015 contiene 155 notas de modificación). SUIN-Juriscol, del Ministerio de Justicia, sí publica el estado como dato, y es la única fuente del país que lo hace: cuando la norma está en el índice empaquetado,resolver_citadevuelve ese estado con su enlace.

Tres advertencias sobre ese dato, todas comprobadas:

- Se entrega literal, nunca traducido a un sí o un no.SUIN distingue «Vigente», «DEROGADO», «Vigencia en Estudio», «Compilado», «Declarado Inexequible» y «Norma no vigente porque agotó su objeto». «Vigencia en Estudio» no significa vigente.
- El estado se lee del registro del documento, no de su prosa.Donde aparecen los dos se contradicen: la Ley 1541 de 2012 muestra «Vigente» en pantalla y «Vigencia en Estudio» en su campo.
- El buscador de SUIN no sirve para esto.buscar_en_suindevuelve un campo de vigencia que viene de su índice de búsqueda y contradice la ficha —la Ley 74 de 1923 figura allí como «Vigencia en Estudio» y su ficha dice DEROGADO—, así que se marca como no fiable en cada respuesta.

Y la regla de fondo no cambia:verifica en el enlace antes de actuar.

El buscador del Gestor no busca en el texto completo, solo en los resúmenes temáticos, y une los términos con OR. Su índice de palabras además es muy pobre: «teletrabajo» casa con 3 documentos en todo el portal, y con ninguno de los 43 conceptos que sí están clasificados bajo ese subtema. El servidor compensa de tres formas: quita las palabras vacías antes de consultar, reintenta por el subtema oficial cuando la búsqueda por palabras rinde poco, y busca dentro del articulado en tu computador cuando pides una norma concreta.

Ritmo de consulta.El servidor hace como máximo una petición por segundo sostenida a cada portal, con ráfagas de hasta cinco, y nunca dos a la vez al mismo sitio. Si un portal responde que está limitando las consultas, espera lo que él indique en vez de insistir. Son servicios públicos y conviene que un asistente automático les pese menos que una persona navegando.

Privacidad.Cada consulta viaja a servidores del Estado colombiano, que registran las peticiones y tu dirección IP, igual que si navegaras el sitio. No se envía nada a ningún otro servidor, no hay analítica y no se recoge información tuya. Tenlo en cuenta si vas a consultar sobre un asunto propio.

Datos empaquetados.Se incluyen dos índices, ambos con fecha de generación:

- Eltemático(12.063 subtemas) responde al instante y sigue sirviendo si el portal se cae. Si supera los tres meses, el servidor te lo advierte.
- El deSUIN(11.599 documentos, de 1844 a 2026) traduce una cita a su documento, porque SUIN no tiene buscador utilizable. La vigencia se consulta en vivo; el índice solo dice dónde mirar.Cubre leyes, no decretos: los sitemaps de decretos del portal devuelven 404, así que para un decreto la vigencia normalmente no consta —lo que no significa ni que esté vigente ni que esté derogado.

Cobertura de la búsqueda tributaria.La primera consulta de cada término a la DIAN tarda unos 20 segundos: su portal devuelve el resultado completo y no admite límite. Las páginas siguientes del mismo término son instantáneas, así que conviene paginar en lugar de repetir búsquedas.

El enlace del Consejo de Estado caduca; el radicado no.buscar_jurisprudencia_consejo_estadoentrega, junto a cada providencia, un token firmado que emite el propio buscador y con el queobtener_documentocon fuenteconsejosaca el texto del PDF. Ese tokenvive una hora: sirve para leer, no para citar. Para citar se usa el radicado. Si caducó, se repite la búsqueda y sale uno nuevo.

El texto de la Corte Suprema se pide con su ruta y su sala.buscar_jurisprudencia_supremadevuelve la referencia, el ponente, la fecha y las normas citadas;obtener_documentocon fuentesupremadevuelve el texto completo, pero exige la MISMA sala con la que apareció la providencia: el backend la busca dentro de esa sala y desde otra no la encuentra.

La relatoría no indexa frases largas.buscar_jurisprudenciacon varias palabras («mora querella policiva») hace que el buscador de la Corte responda con un aviso de «búsquedas flexibles» y 0 resultados. El servidor lo detecta, reintenta con la palabra más distintiva del término («querella») y lo anuncia en la respuesta: «La relatoría no indexa la frase completa; se buscó con el núcleo «X»». Verifica la pertinencia del resultado contra lo que buscabas.

npm install npm run check # typecheck + lint + pruebas de biblioteca + de extremo a extremo npm run medir # métricas: bundle, arranque, índices y una fila por herramienta (p50/p95/peticiones/bytes) npm run generar-indice # regenera datos/indice-tematico.json (~20 MB de descarga) npm run generar-indice-suin # regenera datos/indice-suin.json (~45 min; reanudable) npm run pack # produce normativa-colombia.mcpb

datos/sí está versionado: sin él un clon limpio no pasa las pruebas, y el índice de SUIN cuesta 45 minutos de peticiones a un servicio público. Regenéralos solo cuando quieras actualizarlos.

Las pruebas consultan los portales oficiales.SIN_RED=1 npm testcorre solo la lógica pura, útil para iterar rápido o sin conexión.

No hay integración continua:npm run checkse corre a mano antes de publicar. Conviene ejecutarlo cada tanto aunque no se haya tocado el código, porque es lo que detecta que un portal cambió su HTML.

El ficheroglama.jsonde la raíz declara los metadatos del servidor en elregistro de Glama(schema oficial conmaintainers); se empaqueta en el.mcpby viaja en el paquete npm. El checklist de calidad y el diagnóstico de las descripciones de las herramientas viven enCALIDAD_HERRAMIENTAS_GLAMA.md(nota de trabajo, no se publica en npm).

Las guías están enCONTRIBUTING.md, y hay cuatro reglas que no se negocian: el canario nunca devuelve vacío en silencio, no se desactiva la verificación TLS, no se sube el ritmo de peticiones a los portales y ninguna respuesta afirma vigencia.

Si el servidor te dio una respuesta incorrecta, ese es el reporte más valioso: hay unaplantilla de issuepara eso.

Para reportar una vulnerabilidad, miraSECURITY.md; no abras un issue público.

Código bajo licencia MIT (verLICENSE). Sobre los contenidos normativos y el acceso automatizado a los portales, miraNOTICE.md.

Prevents regression by providing Blast Radius data to AI based on your git history