Skip to main content
Glama
juandavidsernav

secop-mcp-server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
SOCRATA_APP_TOKENNoApp token from datos.gov.co to avoid aggressive rate limiting.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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:

  • Personas/proveedores únicos contratados

  • Total de contratos

  • Valor total contratado

  • Valor pagado

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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

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