Skip to main content
Glama

Better Llama — Chile data

Licitaciones y compras públicas de Chile (Mercado Público)

search_chile_public_tenders
Read-onlyIdempotent

Busca licitaciones, órdenes de compra y Compra Ágil del Estado de Chile en Mercado Público (ChileCompra): por código, fecha, estado, organismo comprador, proveedor, región o palabra clave. Devuelve JSON normalizado (montos, fechas ISO, estado, comprador, ítems) sin datos personales de funcionarios. Requiere tu propio ticket gratuito de ChileCompra (argumento "ticket" o encabezado X-MercadoPublico-Ticket). / Search Chile public procurement tenders, purchase orders and Compra Ágil.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "search_chile_public_tenders"
  }
}

Input Schema

NameRequiredDescriptionDefault
codesNoCódigos específicos / Specific codes — Opcional. Si se indican, se consulta la ficha de cada código e ignoran los demás filtros. Ej.: 1509-5-L114 (licitación), 1057532-156-AG26 (OC), 1057539-228-COT26 (Compra Ágil). / Optional: fetch these codes only.
dateToNoHasta (fecha) / To date — YYYY-MM-DD, inclusive. Por defecto igual a 'Desde' (o hoy).
sourceNoFuente de datos / Data source — licitaciones = tenders (API v1); ordenes_compra = purchase orders (API v1); compra_agil = Compra Ágil (API v2, BETA — la API oficial está en beta y aún no se ha validado con datos reales; puede fallar con 504).licitaciones
ticketNoTicket de la API de Mercado Público / API ticket — Tu clave personal y gratuita del proveedor (https://www.chilecompra.cl/api/). También puedes enviarla en un encabezado HTTP (ver la ficha de la herramienta). Se usa solo en esa solicitud; nunca se guarda ni se registra.
keywordNoPalabras clave (Compra Ágil) / Keywords — [BETA] Solo para 'compra_agil': búsqueda en nombre/descripción (parámetro q de la API).
regionsNoRegiones (Compra Ágil) / Regions — [BETA] Solo para 'compra_agil'. Región del organismo comprador. Vacío = todo Chile.
buyerRutNoRUT del organismo (Compra Ágil) / Buyer RUT — [BETA] Solo para 'compra_agil'. La API v2 no filtra por organismo; este filtro se aplica localmente. Combínalo con una región para ahorrar cuota.
dateFromNoDesde (fecha) / From date — YYYY-MM-DD, día calendario de Chile. Por defecto: hoy. Licitaciones/OC: una consulta por día; la API devuelve los registros asociados a esa fecha según su propio criterio (en pruebas reales incluye licitaciones publicadas, cerradas y adjudicadas ese día, no solo las publicadas). Compra Ágil: fecha de publicación. Máx. 31 días por llamada.
maxItemsNoMáximo de resultados a devolver (1-25). Por defecto 10.
buyerCodeNoCódigo de organismo comprador / Buyer code — Licitaciones/OC: CodigoOrganismo numérico (ej. 6945). Se combina con la fecha.
fetchDetailsNoObtener ficha completa / Fetch full details — Los listados por fecha solo traen datos básicos (código, nombre, estado, cierre). Activado: se consulta la ficha de cada resultado (organismo, montos, fechas). Usa 1 solicitud extra de tu cuota por resultado.
supplierCodeNoCódigo de proveedor / Supplier code — Licitaciones/OC: CodigoProveedor numérico de Mercado Público (ej. 17793). No es el RUT.
tenderStatusNoEstado de licitación / Tender status — Solo para 'licitaciones'. 'activas' = todas las publicadas hoy (ignora fechas si no indicas fechas).
agileStatusesNoEstados de Compra Ágil / Compra Ágil statuses — [BETA] Solo para 'compra_agil'. Vacío = todos.
purchaseOrderStatusNoEstado de orden de compra / Purchase order status — Solo para 'ordenes_compra'. Valores tal como los publica la documentación oficial.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.1/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, openWorldHint and destructiveHint=false, so the safety profile is covered and the description is not required to restate it. The description still adds genuinely new behavior: normalized JSON output (ISO dates, amounts, buyer, items), the privacy guarantee that official's personal data is excluded, and the authentication requirement. It does not mention rate limits or pagination, which keeps it below a 5.

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

Conciseness4/5

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

Two dense, front-loaded sentences that put the resource and the filter axes first, then the return shape and auth requirement. The trailing English sentence is a near-verbatim restatement of the opening, which is useful for cross-lingual retrieval but is the one piece of redundancy.

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?

For a 15-parameter, no-output-schema, multi-source tool, the description covers what the tool does, what it returns in general terms, the auth requirement and the privacy constraint. Remaining gaps (pagination, quota consumption, source-specific behavior) are handled inside the schema descriptions, so the definition is complete enough to call it correctly.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already documents all 15 parameters in depth, including beta caveats and quota costs. The description's filter list adds only a high-level summary of the same axes; it contributes no format, syntax, or interaction detail beyond what the schema provides. Baseline 3 applies.

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 and resource ('Busca licitaciones, órdenes de compra y Compra Ágil del Estado de Chile en Mercado Público') and enumerates the filter axes (código, fecha, estado, organismo, proveedor, región, palabra clave). It is clearly distinguishable from the sibling Chile-data tools, which cover gazette, calendar/RUT, fuel, banking, earthquakes, etc.

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?

Gives the operational precondition (a free ChileCompra ticket, either the 'ticket' argument or the X-MercadoPublico-Ticket header) and implicitly routes selection through the three data sources. It does not explicitly say when to prefer this tool over another or when not to call it, but the domain is narrow enough that the context is unambiguous.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources