colombia-datos-mcp
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., "@colombia-datos-mcp busca contratos de SECOP con la Alcaldía de Medellín en 2024"
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.
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 II, datos.gov.co | Columnas verificadas; filtros por probar en vivo |
| SECOP II, datos.gov.co | Ídem |
| Metadatos de datos.gov.co | Para validar columnas |
| OFAC (SDN y alias) | Probado con datos sintéticos |
| Extracto abierto RUES ( | Columnas verificadas; consulta por probar en vivo |
| Rama Judicial | Listo (endpoint verificado el 2026-10-29) |
| Rama Judicial | Listo (endpoint verificado el 2026-10-29) |
| Í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
pytestUso 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-mcpChatGPT (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 8000El 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.jsonlCada 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
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.
Probar en vivo con
python prueba_en_vivo.pytras cada cambio. Para incluir Rama Judicial, definaRADICADO_PRUEBAcon un radicado público de 23 dígitos.
Seguridad y privacidad
No suba
.envni el índice local. El.gitignoreincluido 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).
Aviso legal
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 toolsempresas_buscarEmpresas BuscarBRead-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 EstadoBRead-onlyIdempotent
Cantidad de documentos del índice local por tipo.
Inputs: no named parameters. Returns: object
jurisprudencia_buscar_localJurisprudencia Buscar LocalBRead-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 ActuacionesBRead-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 RadicadoBRead-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 CribarBRead-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 ContratosCRead-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 ProcesosCRead-onlyIdempotent
Busca procesos de contratación (licitaciones, convocatorias) en SECOP II.
Inputs: texto, limite, pagina, nit_entidad. Returns: object
secop_describir_datasetSecop Describir DatasetARead-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
Scored across 9 tools
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.
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.
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.
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
Related MCP Connectors
JusPronto is case-management software for Brazilian law firms. Its remote MCP server (OAuth 2.1 with PKCE, per-permission scopes, audit log) lets Claude and ChatGPT read the firm's own cases, deadlines, agenda, recent court movements and case files with the page cited. Write actions require the lawyer's approval. Requires a JusPronto account.
Busca jurisprudencia española desde Claude, ChatGPT y otros clientes MCP. Localiza resoluciones, consulta sus fundamentos y el fallo cuando estén disponibles y comprueba los pasajes con enlaces a las fuentes oficiales para preparar tu investigación jurídica. Conecta tu cuenta mediante OAuth o utiliza una clave API. Los resúmenes se distinguen del texto íntegro; la cobertura es progresiva y no exhaustiva.
One connection to Avokata, Rekvira and Victano inside your AI assistant. Discover and enable services for Lithuanian law and court practice, EU regulation, public tenders and grant calls. Use their tools and guided workflows without adding each connector separately. Free during beta; sign in with your email. --- Viena MCP jungtis prie „Avokata“, „Rekvira“ ir „Victano“ jūsų DI asistente (Claude, ChatGPT ir kt.). Atraskite ir įjunkite reikiamas paslaugas: Lietuvos teisę ir teismų praktiką, ES reguliavimą, viešuosius pirkimus ir finansavimo kvietimus. Naudokitės jų įrankiais ir darbo eigomis nepridėdami kiekvienos jungties atskirai. Beta laikotarpiu nemokama; prisijunkite el. paštu.
Resolve, search and verify legal citations against the official sources, with provenance.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to query Colombian government procurement data via MCP tools or natural language questions.91 npmMIT
- AlicenseNot gradedqualityCmaintenanceConnects 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
- AlicenseAqualityBmaintenanceEnables 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.31MIT
- AlicenseBqualityCmaintenanceExposes 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.108MIT