secop-mcp

MCP para consultar datos de contratación pública colombiana (SECOP II) desde datos.gov.co vía Socrata API.

Ejecutar

cd servers/secop-mcp
uv run fastmcp dev server.py   # Inspector web
uv run fastmcp run server.py   # Ejecución directa

Tools disponibles

Tool	Descripción
buscar_contratos	Busca contratos por keyword, entidad, departamento, modalidad, estado, rango de valor
buscar_procesos	Busca procesos de contratación (licitaciones, convocatorias)
detalle_contrato	Detalle completo de un contrato por su ID
buscar_por_proveedor	Contratos adjudicados a un proveedor por nombre o NIT
buscar_por_entidad	Contratos o procesos de una entidad pública
salud_financiera	Análisis financiero cruzando contratos, ejecución, adiciones y facturas
consultar_adiciones	Adiciones (modificaciones) a contratos
plan_adquisiciones	Plan Anual de Adquisiciones (PAA)
info_proveedor	Información detallada de un proveedor registrado
estadisticas	Estadísticas agregadas: totales, promedios, rankings
documentos_contrato	Metadatos de documentos adjuntos e intento de descarga directa de PDFs públicos. Si el portal requiere JS/reCAPTCHA, notifica cómo instalar el MCP de Playwright

Datasets SECOP II

Dataset	ID
Contratos Electrónicos	jbjy-vk9h
Procesos de Contratación	p6dx-8zbt
Ejecución Contratos	mfmm-jqmq
Proveedores Registrados	qmzu-gj57
PAA Encabezado	b6m4-qgqv
Adiciones	cb9c-h8sn
Facturas	ibyt-yi2f

Configuración

1. Copia .env.example a .env:

   cp .env.example .env

2. (Opcional) Agrega tu App Token de Socrata para mayor rate limit:

   SOCRATA_APP_TOKEN=tu-token-aqui
   

Creado con mcp-factory.