{
  "markdown": "# SECOP MCP Server\n\n<!-- mcp-name: io.github.juandavidsernav/secop-mcp-server -->\n\nServidor [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) para consultar la contratación pública de Colombia a través de SECOP I y SECOP II.\n\nLos datos se obtienen en tiempo real desde [datos.gov.co](https://www.datos.gov.co/) (API SODA de Socrata) y son 100% públicos. No se almacena ningún dato localmente.\n\n## ¿Para qué sirve?\n\nEste servidor permite que modelos de lenguaje como Claude consulten directamente los datos de contratación pública del Estado colombiano. Esto facilita:\n\n- **Control político:** Investigar contratos de entidades públicas y funcionarios.\n- **Transparencia:** Verificar contratistas, montos y modalidades de contratación.\n- **Periodismo de datos:** Cruzar información de proveedores y entidades.\n- **Veeduría ciudadana:** Cualquier persona puede consultar cómo se gastan los recursos públicos.\n\n## Datasets disponibles\n\n| Dataset | Descripción | Fuente |\n|---|---|---|\n| **SECOP I - Procesos** | Datos históricos de procesos de compra pública | [datos.gov.co](https://www.datos.gov.co/d/f789-7hwg) |\n| **SECOP II - Procesos** | Procesos de contratación transaccionales | [datos.gov.co](https://www.datos.gov.co/d/p6dx-8zbt) |\n| **SECOP II - Contratos** | Contratos electrónicos con valores pagados/facturados | [datos.gov.co](https://www.datos.gov.co/d/jbjy-vk9h) |\n| **SECOP II - Proveedores** | Proveedores registrados en la plataforma | [datos.gov.co](https://www.datos.gov.co/d/qmzu-gj57) |\n\n## Herramientas (Tools)\n\n| Tool | Descripción |\n|---|---|\n| `buscar_secop1` | Buscar procesos en SECOP I por entidad, contratista, objeto, departamento, rango de fechas, etc. |\n| `buscar_procesos_secop2` | Buscar procesos de contratación en SECOP II con filtros temporales |\n| `buscar_contratos_secop2` | Buscar contratos electrónicos en SECOP II con filtros temporales |\n| `buscar_proveedores` | Buscar proveedores registrados en SECOP II |\n| `buscar_por_persona` | Buscar en TODOS los datasets por cédula/NIT o nombre de una persona |\n| `resumen_contratacion` | Vista condensada de contratos (campos clave: entidad, proveedor, valor, estado, fecha) |\n| `agregaciones_contratacion` | Totales agrupados por proveedor, entidad, departamento o modalidad |\n| `consulta_libre` | Consulta SoQL avanzada sobre cualquier dataset |\n| `listar_datasets` | Ver todos los datasets y sus campos disponibles |\n\n## Instalación\n\n### Requisitos\n\n- Python 3.11+\n- [uv](https://docs.astral.sh/uv/) (recomendado) o pip\n\n### Opción 1: Desde PyPI (recomendada)\n\n```bash\n# Con uv (más rápido)\nuvx secop-mcp-server\n\n# Con pip\npip install secop-mcp-server\n```\n\n### Opción 2: Desde GitHub\n\n```bash\nuvx --from git+https://github.com/juandavidsernav/secop-mcp-server secop-mcp\n```\n\n### Opción 3: Desde el código fuente\n\n```bash\ngit clone https://github.com/juandavidsernav/secop-mcp-server.git\ncd secop-mcp-server\nuv sync\n```\n\n## Configuración\n\n### Claude Code\n\n```bash\n# Instalación rápida desde PyPI\nclaude mcp add secop-colombia -- uvx secop-mcp-server\n\n# O desde código fuente\nclaude mcp add secop-colombia -- uv run --directory /ruta/al/secop-mcp-server secop-mcp\n```\n\n### Claude Desktop\n\nEdita el archivo de configuración:\n\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"secop-colombia\": {\n      \"command\": \"uvx\",\n      \"args\": [\"secop-mcp-server\"]\n    }\n  }\n}\n```\n\n### App Token (opcional pero recomendado)\n\nSin token funciona, pero con rate-limiting agresivo (~60 peticiones/hora). Obtén uno gratis:\n\n1. Regístrate en [datos.gov.co](https://www.datos.gov.co/)\n2. Ve a tu perfil > Developer Settings\n3. Crea un nuevo App Token\n\nConfigúralo como variable de entorno:\n\n```json\n{\n  \"mcpServers\": {\n    \"secop-colombia\": {\n      \"command\": \"uvx\",\n      \"args\": [\"secop-mcp-server\"],\n      \"env\": {\n        \"SOCRATA_APP_TOKEN\": \"tu-token-aqui\"\n      }\n    }\n  }\n}\n```\n\n## Ejemplos de uso\n\nUna vez configurado, puedes pedirle a Claude cosas como:\n\n- \"Busca los contratos de la Alcaldía de Bogotá por más de 1000 millones\"\n- \"¿Qué contratos tiene la persona con cédula 12345678?\"\n- \"Muestra los procesos de licitación pública en Antioquia\"\n- \"¿Cuáles son los contratos más grandes de SECOP II este año?\"\n- \"Busca todos los contratos asociados a la empresa XYZ\"\n- \"¿Cuánto ha contratado el municipio de Medellín en prestación de servicios?\"\n- \"Dame un resumen de los contratos de EPM en 2024\"\n- \"¿Cuáles son los proveedores con más contratos en Antioquia?\"\n- \"Agrupa por modalidad los contratos de la Alcaldía de Medellín\"\n- \"Muestra los contratos firmados entre enero y marzo de 2025 en el Valle del Cauca\"\n\n## Estructura del proyecto\n\n```\nsecop-mcp-server/\n├── secop_mcp/\n│   ├── __init__.py    # Documentación del paquete\n│   ├── server.py      # Servidor MCP y definición de herramientas (tools)\n│   ├── client.py      # Cliente HTTP para la API SODA de Socrata\n│   └── datasets.py    # Catálogo de datasets SECOP y sus metadatos\n├── pyproject.toml     # Configuración del paquete Python\n├── LICENSE            # Licencia MIT\n└── README.md          # Este archivo\n```\n\n## ¿Cómo funciona?\n\n```\nClaude (LLM) <--MCP/stdio--> secop-mcp-server <--HTTP/SoQL--> datos.gov.co (API SODA)\n```\n\n1. Claude invoca una herramienta MCP (ej: `buscar_contratos_secop2`).\n2. El servidor construye una consulta SoQL con los filtros proporcionados.\n3. Se ejecuta la petición HTTP a la API de datos.gov.co.\n4. Los resultados se formatean en texto legible y se retornan a Claude.\n5. Claude analiza los datos y responde al usuario.\n\nTodo corre **localmente** en tu máquina. No hay servidor intermedio ni se almacenan datos.\n\n## Contribuir\n\nLas contribuciones son bienvenidas:\n\n1. Fork del repositorio\n2. Crea una rama para tu feature (`git checkout -b feature/nueva-funcionalidad`)\n3. Commit de tus cambios (`git commit -m 'Agrega nueva funcionalidad'`)\n4. Push a la rama (`git push origin feature/nueva-funcionalidad`)\n5. Abre un Pull Request\n\n### Ideas para contribuir\n\n- Agregar más datasets de datos.gov.co\n- Traducciones del README\n- Alertas o monitoreo de nuevos contratos\n- Exportación a CSV/Excel\n\n## Licencia\n\n[MIT](LICENSE) - Libre para uso personal, comercial, modificación y redistribución.\n",
  "bytes": 6306,
  "sha": "acebfea81f76d71cc9bc3cf961926273284408d9bcba1a85b89f6a679f45c8fd",
  "repo_slug": "juandavidsernav/secop-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_juandavidsernav_secop_mcp_serv_2ef5460f/readme"
}