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. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| 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 | |
TDQS
Scored across 10 tools
Each tool has a clearly distinct purpose: searching contracts, processes, providers, people, aggregating, free querying, listing datasets, summarizing, and counting. Descriptions explicitly differentiate them, and no two tools overlap in functionality.
All tool names follow a consistent verb_noun pattern in Spanish (e.g., buscar_contratos_secop2, listar_datasets, contar_personas_contratadas). The naming is uniform with lowercase and underscores, making it predictable for agents.
10 tools is well-scoped for the domain of Colombian public procurement. Each tool addresses a specific need without being excessive, covering search, aggregation, listing, free query, and summary.
The tool set covers the full range of typical procurement data exploration: searching both current and historical platforms, by various criteria, aggregating, summarizing, and counting. The free query tool ensures flexibility for advanced use cases.