Skip to main content
Glama

colombia-datos-mcp

Servidor MCP propio con datos públicos de Colombia (contratación, sanciones, empresas, procesos judiciales, jurisprudencia y normas), pensado para usarse desde Claude y ChatGPT sin intermediarios de pago. Cada respuesta incluye fuente, URL, fecha de consulta y una marca de si el endpoint está verificado.

Borrador técnico sujeto a revisión del abogado responsable. Arquitectura y alcance: docs/ARQUITECTURA.md.

Herramientas

Herramienta

Fuente

Estado

secop_buscar_contratos

SECOP II, datos.gov.co

Columnas verificadas; filtros por probar en vivo

secop_buscar_procesos

SECOP II, datos.gov.co

Ídem

secop_describir_dataset

Metadatos de datos.gov.co

Para validar columnas

sanciones_ofac_cribar

OFAC (SDN y alias)

Probado con datos sintéticos

empresas_buscar

Extracto abierto RUES (c82u-588k)

Columnas verificadas; consulta por probar en vivo

procesos_consultar_radicado

Rama Judicial

Listo (endpoint verificado el 2026-10-29)

procesos_actuaciones

Rama Judicial

Listo (endpoint verificado el 2026-10-29)

jurisprudencia_buscar_local

Índice local SQLite

Requiere ingesta propia

Todas son de solo lectura.

Related MCP server: Aliado Libre

Instalación

git clone https://github.com/oscarag2233-cyber/colombia-datos-mcp.git && cd colombia-datos-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
cp .env.example .env     # complete lo que aplique
pytest

Uso con asistentes de IA

Cada persona ejecuta su propia copia del servidor en su equipo; no existe un servidor compartido. Sustituya /RUTA por la carpeta donde instaló el proyecto.

Claude Desktop (verificado). Cierre la aplicación por completo antes de editar el archivo claude_desktop_config.json y agregue la entrada; vuelva a abrirla después.

{
  "mcpServers": {
    "colombia-datos": { "command": "/RUTA/.venv/bin/colombia-datos-mcp" }
  }
}

Claude Code.

claude mcp add colombia-datos -- /RUTA/.venv/bin/colombia-datos-mcp

ChatGPT (uso avanzado, sin instalación de un clic). Los servidores MCP personalizados de ChatGPT requieren una conexión por URL o por Secure MCP Tunnel; según la documentación de OpenAI consultada el 29 de octubre de 2026, la autenticación admitida es OAuth o ninguna, y la disponibilidad depende del plan y de los permisos del espacio de trabajo. Consulte la documentación vigente antes de configurarlo.

Gemini CLI (pendiente de verificación). La documentación del Gemini CLI describe la conexión de servidores MCP locales mediante su archivo de configuración. Esta configuración no ha sido probada en este proyecto; no se garantiza su funcionamiento con la aplicación web de Gemini.

Servidor HTTP (solo para usuarios avanzados).

colombia-datos-mcp --http --host 127.0.0.1 --port 8000

El modo HTTP no incluye autenticación. No lo exponga a internet sin añadir autenticación y límites de uso.

Índice local de jurisprudencia y normas

colombia-datos-ingest ruta/a/carpeta_o_archivo.jsonl

Cada documento exige titulo, texto, url_oficial y fecha_consulta; sin ellos se rechaza. Recomendado: corporacion, numero, radicado, fecha, ponente, tipo. Si la búsqueda no arroja resultados, la herramienta indica: «No se encontró jurisprudencia oficial disponible.»

Configuración pendiente

  1. Rama Judicial. Endpoint de consulta por radicado verificado el 2026-10-29 (API interna del portal, puede cambiar sin aviso). Actuaciones verificadas el 2026-10-29; pendiente: documentos adjuntos y sujetos procesales.

  2. Probar en vivo con python prueba_en_vivo.py tras cada cambio. Para incluir Rama Judicial, defina RADICADO_PRUEBA con un radicado público de 23 dígitos.

Seguridad y privacidad

  • No suba .env ni el índice local. El .gitignore incluido los excluye.

  • Si usa un repositorio público, no incluya datos de clientes ni radicados de casos.

  • Identidad, vehículos por propietario y antecedentes están fuera de alcance por tratarse de datos personales (ver arquitectura).

  • Este proyecto no es una fuente oficial ni está afiliado a ninguna entidad pública. Consulta datos abiertos y portales públicos; la información debe contrastarse con la fuente oficial antes de usarla en un trámite o actuación.

  • La consulta de la Rama Judicial utiliza una API interna del portal, no un servicio documentado; puede cambiar o dejar de funcionar sin aviso, y su uso debe respetar las condiciones del portal. Un resultado vacío no prueba que un proceso no exista.

  • Una coincidencia de cribado OFAC es un indicio, no una determinación de identidad.

  • El software se ofrece «tal cual», sin garantías (ver LICENSE). El usuario es responsable del uso que haga de los resultados y del cumplimiento de la normativa de protección de datos personales aplicable.

Licencia

MIT. Ver el archivo LICENSE.

Available Tools

9 tools
empresas_buscarEmpresas BuscarB
Read-onlyIdempotent

Busca datos básicos de una empresa en el extracto abierto del RUES (requiere DS_RUES_ABIERTO).

Inputs: nit, limite, nombre. Returns: object

indice_local_estadoIndice Local EstadoB
Read-onlyIdempotent

Cantidad de documentos del índice local por tipo.

Inputs: no named parameters. Returns: object

jurisprudencia_buscar_localJurisprudencia Buscar LocalB
Read-onlyIdempotent

Busca en el índice local de jurisprudencia y normas cargadas por el titular desde fuentes oficiales.

Si no hay resultados responda literalmente: «No se encontró jurisprudencia oficial disponible.»

Inputs: texto (required), tipo, limite. Returns: object

procesos_actuacionesProcesos ActuacionesB
Read-onlyIdempotent

Lista las actuaciones de un proceso judicial por radicado de 23 dígitos (consulta pública).

Inputs: radicado (required), pagina. Returns: object

procesos_consultar_radicadoProcesos Consultar RadicadoB
Read-onlyIdempotent

Consulta un proceso judicial por radicado de 23 dígitos (consulta pública; API interna del portal).

Inputs: radicado (required), solo_activos. Returns: object

sanciones_ofac_cribarSanciones Ofac CribarB
Read-onlyIdempotent

Criba un nombre contra la lista SDN de OFAC (con alias). Es un indicio, no una determinación.

Inputs: nombre (required), limite, umbral. Returns: object

secop_buscar_contratosSecop Buscar ContratosC
Read-onlyIdempotent

Busca contratos estatales en SECOP II (datos.gov.co). Fechas en AAAA-MM-DD.

Inputs: desde, hasta, texto, limite, +4 more. Returns: object

secop_buscar_procesosSecop Buscar ProcesosC
Read-onlyIdempotent

Busca procesos de contratación (licitaciones, convocatorias) en SECOP II.

Inputs: texto, limite, pagina, nit_entidad. Returns: object

secop_describir_datasetSecop Describir DatasetA
Read-onlyIdempotent

Devuelve columnas y metadatos reales de un dataset de datos.gov.co (clave configurada o ID Socrata).

Inputs: dataset. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 9 tools

    Disambiguation4/5

    Each tool targets a distinct resource (SECOP contracts, SECOP processes, datasets, OFAC sanctions, RUES companies, judicial radicados, jurisprudence), but secop_buscar_contratos vs secop_buscar_procesos and indice_local_estado vs jurisprudencia_buscar_local could be confused at a glance. The descriptions do clarify the boundaries, though 'procesos' is overloaded across procurement and judicial domains.

    Naming Consistency4/5

    Strong domain-prefix grouping (secop_, procesos_, empresas_, sanciones_, indice_, jurisprudencia_) with Spanish verb_noun structure in most cases. Minor deviations: indice_local_estado and procesos_actuaciones are noun phrases without a verb, breaking the action pattern slightly.

    Tool Count4/5

    Nine tools is a well-scoped size for a multi-domain public-data server. Each domain (procurement, judicial, sanctions, companies, jurisprudence) gets one or two tools, so nothing feels redundant, though the set spans several loosely related areas.

    Completeness3/5

    Coverage is uneven: judicial processes have both lookup and actuaciones, but SECOP has only search plus dataset introspection with no detail/record fetch, and sanctions screening covers OFAC only (no local Colombian sanction lists). Agents will hit dead ends fetching full contract or company records.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Connects AI assistants via MCP to Colombian legislation and jurisprudence with verifiable citations. Enables hybrid search over a local index of over 44,000 legal documents, returning exact, sourced quotes without generating text.
      AGPL 3.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables Claude, Cursor, and other MCP clients to search Spanish BOE/BORME gazettes, open and forthcoming EU funding calls, and TED public procurement notices through read-only tools that return live JSON with source links.
      3
      1
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Exposes Colombia's SECOP II and Colombia Compra Eficiente procurement layers to LLM agents, enabling SODA SoQL process and contract searches, deep opportunity inspection and ASP.NET spidering, COP budget analytics, and generation of RAG-ready vector chunks and feeds.
      10
      8
      MIT