Skip to main content
Glama
edwin042331-hue

dgcp-mcp-server

by edwin042331-hue
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Buscar contratos adjudicados (DGCP)

dgcp_buscar_contratos
Read-onlyIdempotent

Search Dominican Republic public contracts to find who won, amount, date, and payment terms. Filter by process code, RPE, institution, supplier, amount, or status.

Instructions

Contratos firmados por el Estado dominicano: quien gano, cuanto, cuando, forma y plazo de pago. Filtros exactos en el servidor: codigo_proceso, rpe, institucion (resuelta a su codigo oficial), con cobertura total del filtro. Sin esos filtros solo se analizan los ~3,000 contratos mas recientes (la API no filtra contratos por fecha ni por texto).

Input Schema

NameRequiredDescriptionDefault
rpeNoRPE del adjudicatario (filtro exacto en servidor).
limiteNoResultados a mostrar (default 10).
terminoNoPalabras en descripcion, proveedor o codigos (alternativas separadas por coma).
monto_maxNo
monto_minNo
proveedorNoNombre (o parte) del adjudicatario.
institucionNoInstitucion: nombre, acronimo o codigo de unidad de compra.
codigo_procesoNoCodigo del proceso (filtro exacto en servidor).
estado_contratoNoActivo, Cerrado, Cancelado, Rescindido, Modificado, 'Flujo en aprobacion'.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed10 schema fields changedv5.0.0
    • changedInput schema / properties / codigo_proceso / description
      Previous value: -"Codigo del proceso de licitacion asociado (ej. 'HLA-DAF-CD-2026-0121')."New value: +"Codigo del proceso (filtro exacto en servidor)."
    • changedInput schema / properties / estado_contrato / description
      Previous value: -"Estado del contrato (ej. 'Activo', 'Cerrado', etc.)."New value: +"Activo, Cerrado, Cancelado, Rescindido, Modificado, 'Flujo en aprobacion'."
    • changedInput schema / properties / institucion / description
      Previous value: -"Nombre o parte del nombre de la institucion (unidad de compra)."New value: +"Institucion: nombre, acronimo o codigo de unidad de compra."
    • changedInput schema / properties / limite / description
      Previous value: -"Cuantos resultados devolver (default 10)"New value: +"Resultados a mostrar (default 10)."
    • removedInput schema / properties / monto_max / description
      Removed value: -"Monto maximo contratado en DOP"
    • removedInput schema / properties / monto_min / description
      Removed value: -"Monto minimo contratado en DOP"
    • removedInput schema / properties / paginas
      Removed value: -{
-  "description": "Cuantas paginas de la API escanear (default 5, 100 contratos c/u)",
-  "maximum": 20,
-  "minimum": 1,
-  "type": "integer"
-}
    • changedInput schema / properties / proveedor / description
      Previous value: -"Nombre o razon social de la empresa adjudicataria."New value: +"Nombre (o parte) del adjudicatario."
    • changedInput schema / properties / rpe / description
      Previous value: -"Numero de Registro de Proveedores del Estado (RPE) del adjudicatario."New value: +"RPE del adjudicatario (filtro exacto en servidor)."
    • changedInput schema / properties / termino / description
      Previous value: -"Texto a buscar en descripcion, codigo de contrato o proceso, proveedor o institucion."New value: +"Palabras en descripcion, proveedor o codigos (alternativas separadas por coma)."
  2. First observedv4.1.0

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Con readOnlyHint=true, destructiveHint=false e idempotentHint=true ya declaradas, la descripción añade detalles no cubiertos por anotaciones: que ciertos filtros son exactos en servidor, que institucion se resuelve a código oficial, y la limitación de la API (solo ~3,000 contratos recientes sin filtro). No menciona paginación ni formato de salida, pero cubre bien las restricciones clave.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Dos frases bien estructuradas, con la información de filtros exactos y la advertencia de cobertura limitada colocadas en orden de importancia. No hay relleno y cada oración aporta información operativa.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Para una herramienta de solo lectura con 9 parámetros opcionales, sin esquema de salida, la descripción cubre lo esencial: qué devuelve, qué filtros son exactos y la limitación de la API. Queda un pequeño vacío sobre los parámetros de rango de monto y el parámetro limite, pero no impide el uso correcto.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

La cobertura del esquema es del 78%, lo que da una base alta. La descripción añade valor semántico al aclarar que codigo_proceso, rpe e institucion son filtros exactos en servidor y que institucion se resuelve a su código oficial, información que el esquema solo insinúa. Sin embargo, no cubre monto_min/monto_max, estado_contrato ni limite.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (buscar) and resource (contratos adjudicados/firmados por el Estado) y enumera los datos que devuelve (quién ganó, cuánto, cuándo, forma y plazo de pago). Se distingue claramente de hermanos como dgcp_buscar_licitaciones u dgcp_buscar_ofertas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explica cuándo usar filtros exactos y advierte que sin esos filtros solo se analizan los ~3,000 contratos más recientes porque la API no filtra por fecha ni por texto. No nombra explícitamente alternativas (p.ej. dgcp_inteligencia_proceso), pero da contexto operativo suficiente para elegir parámetros.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools