secop-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SOCRATA_APP_TOKEN | No | App token from datos.gov.co to avoid aggressive rate limiting. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| buscar_secop1A | Busca procesos de compra pública en SECOP I (datos históricos). IMPORTANTE: SECOP I es el sistema ANTERIOR, ya NO se usa. Busca primero en SECOP II (buscar_procesos_secop2 o buscar_contratos_secop2). Solo usa esta herramienta si no encontraste resultados en SECOP II o si el contrato es anterior a ~2020. Todos los filtros son opcionales y combinables entre sí (operador AND). |
| buscar_procesos_secop2A | Busca procesos de contratación en SECOP II (plataforma vigente). SECOP II es la plataforma VIGENTE de contratación pública electrónica. Busca aquí PRIMERO antes de buscar en SECOP I. Los procesos incluyen información sobre la entidad contratante, el proveedor seleccionado, valores y estado del procedimiento. Tip: El campo nombre_procedimiento busca en el título del proceso, que a menudo contiene el nombre del proyecto o descripción corta. |
| buscar_contratos_secop2B | Busca contratos electrónicos en SECOP II (plataforma vigente). Los contratos electrónicos contienen información detallada incluyendo valores pagados, facturados y pendientes de pago. Es el dataset más completo para analizar la ejecución financiera de la contratación. Busca aquí PRIMERO antes de buscar en SECOP I. Si conoces el NIT del proveedor, usa nit_proveedor para búsqueda exacta. |
| buscar_proveedoresC | Busca proveedores registrados en SECOP II. Permite identificar proveedores por nombre, NIT o ubicación geográfica. Útil para verificar el registro de un proveedor en la plataforma. |
| consulta_libreA | Consulta libre con SoQL sobre cualquier dataset SECOP. Para consultas avanzadas que las otras herramientas no cubren. Permite escribir cláusulas SoQL directamente, similar a SQL. Documentación SoQL: https://dev.socrata.com/docs/queries/ Ejemplos de cláusulas $where: - "valor_del_contrato > 1000000000" - "departamento = 'Antioquia' AND estado_contrato = 'En ejecución'" - "fecha_de_firma > '2024-01-01'" |
| buscar_por_personaA | Busca en TODOS los datasets de SECOP por número de documento o nombre de una persona/empresa. Útil para encontrar todos los contratos, procesos y registros asociados a un contratista o proveedor específico. Busca simultáneamente en SECOP II Procesos, SECOP II Contratos, SECOP II Proveedores y SECOP I. IMPORTANTE: Si tienes el NIT o cédula, úsalo en el parámetro 'documento'. Es mucho más confiable que buscar por nombre. Esta es la herramienta más completa para investigar el historial de contratación de una persona natural o jurídica con el Estado colombiano. |
| resumen_contratacionA | Resumen condensado de contratos con solo los campos clave. Retorna una vista simplificada con: entidad, proveedor, objeto (truncado), valor, estado y fecha. Ideal para explorar resultados antes de pedir el detalle completo con buscar_contratos_secop2. |
| agregaciones_contratacionA | Agrega contratos de SECOP II por proveedor, entidad, departamento o modalidad. Retorna totales (número de contratos, valor total, valor pagado) agrupados por el campo seleccionado. Útil para detectar concentración de contratos, comparar entidades o analizar modalidades de contratación. |
| contar_personas_contratadasB | Cuenta personas contratadas y valores por año para una entidad. Ideal para KPIs de contratación. Retorna por cada año:
Distingue entre personas naturales (Cédula de Ciudadanía, Cédula de Extranjería) y personas jurídicas (NIT). |
| listar_datasetsA | Lista todos los datasets SECOP disponibles con sus campos de búsqueda. Útil para conocer qué datasets se pueden consultar y qué campos están disponibles para filtrar en cada uno. Esta información es necesaria para usar la herramienta consulta_libre(). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/juandavidsernav/secop-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server