🇨🇱 MCP Mercado Público

Servidor Model Context Protocol (MCP) para la API pública de Mercado Público / ChileCompra. Permite que asistentes de IA consulten licitaciones, órdenes de compra y empresas del Estado chileno en tiempo real.

---

🔑 Paso 1: Obtener tu ticket gratuito

Antes de usar el servidor necesitas tu propio ticket (API key):

1. Ir a api.mercadopublico.cl
2. Iniciar sesión con Clave Única
3. Completar el formulario → el ticket llega a tu correo

El servidor no almacena credenciales. El ticket se pasa como parámetro en cada consulta.

---

⚙️ Paso 2: Configurar en tu IDE

No necesitas clonar ni compilar nada. Usa npx directamente.

Tienes dos formas de pasar tu ticket:

Método	Cuándo usarlo
Variable de entorno MERCADO_PUBLICO_TICKET	Configuras el ticket una sola vez en el IDE — el asistente nunca te lo pedirá
Parámetro ticket en cada tool call	Si no configuraste la env var, pásalo directamente en cada consulta

Se recomienda usar la variable de entorno para una experiencia fluida.

Claude Desktop

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mercado-publico": {
      "command": "npx",
      "args": ["-y", "mcp-mercado-publico"],
      "env": {
        "MERCADO_PUBLICO_TICKET": "TU-TICKET-AQUI"
      }
    }
  }
}

Reinicia Claude Desktop después de guardar.

---

Cursor

Global ~/.cursor/mcp.json · Por proyecto .cursor/mcp.json

{
  "mcpServers": {
    "mercado-publico": {
      "command": "npx",
      "args": ["-y", "mcp-mercado-publico"],
      "env": {
        "MERCADO_PUBLICO_TICKET": "TU-TICKET-AQUI"
      }
    }
  }
}

Verifica en Settings → MCP que el servidor aparezca con punto verde.

---

VS Code (GitHub Copilot)

Requiere VS Code 1.99+ y Copilot en Agent mode.

Por proyecto .vscode/mcp.json:

{
  "servers": {
    "mercado-publico": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-mercado-publico"],
      "env": {
        "MERCADO_PUBLICO_TICKET": "TU-TICKET-AQUI"
      }
    }
  }
}

Global en settings.json:

{
  "mcp": {
    "servers": {
      "mercado-publico": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "mcp-mercado-publico"],
        "env": {
          "MERCADO_PUBLICO_TICKET": "TU-TICKET-AQUI"
        }
      }
    }
  }
}

---

Antigravity (Google DeepMind)

C:\Users\<usuario>\.gemini\antigravity\claude_desktop_config.json

{
  "mcpServers": {
    "mercado-publico": {
      "command": "npx",
      "args": ["-y", "mcp-mercado-publico"],
      "env": {
        "MERCADO_PUBLICO_TICKET": "TU-TICKET-AQUI"
      }
    }
  }
}

---

Windsurf (Codeium)

C:\Users\<usuario>\.codeium\windsurf\mcp_config.json

{
  "mcpServers": {
    "mercado-publico": {
      "command": "npx",
      "args": ["-y", "mcp-mercado-publico"],
      "env": {
        "MERCADO_PUBLICO_TICKET": "TU-TICKET-AQUI"
      }
    }
  }
}

---

Desarrollo local (sin publicar en npm)

Si estás modificando el código fuente, compila primero y apunta al binario local:

npm install && npm run build

{
  "mcpServers": {
    "mercado-publico": {
      "command": "node",
      "args": ["D:\\PROGRAMACION\\NEST-JS\\mcp-mercado-publico\\dist\\main.js"]
    }
  }
}

---

🛠️ Herramientas disponibles

Tool	Descripción
buscar_licitaciones	Lista licitaciones por fecha, estado, proveedor u organismo (nombre o código)
buscar_licitaciones_rango	Busca licitaciones en un rango de fechas (máximo 30 días)
obtener_licitacion	Detalle completo de una licitación por su código
buscar_ordenes_de_compra	Lista órdenes de compra por fecha, estado, proveedor u organismo (nombre o código)
obtener_orden_de_compra	Detalle completo de una OC por su código
buscar_proveedor	Busca un proveedor por su RUT
listar_compradores	Lista todos los organismos públicos disponibles
buscar_organismo	Busca un organismo público por nombre — retorna su CodigoOrganismo
estructura	Retorna la estructura de respuesta JSON de la API nativa para cualquier entidad
consultas	Retorna los parámetros funcionales y diccionarios de anexos para consultar la API
ejemplos_url	Muestra ejemplos reales de URIs HTTP de la API y los distintos formatos soportados
ayuda	Muestra la guía completa de uso del MCP, referencias de códigos y límites operativos

---

💬 Ejemplos de uso

Una vez configurado, puedes preguntarle al asistente cosas como:

¿Cuáles son las licitaciones activas de hoy?
Mi ticket es F8537A18-6766-4DEF-9E59-426B4FEE2844

Busca la licitación con código 1509-5-L114 usando mi ticket ABC123-...

¿Qué órdenes de compra aceptadas existen para el 01042026?

Busca las licitaciones de la Municipalidad de Alto del Carmen

Busca el proveedor con RUT 70.017.820-k

---

📋 Referencia de estados

Licitaciones — parámetro estado

Valor para ?estado=	Código en respuesta
activas	Todas las publicadas hoy
publicada	5
cerrada	6
desierta	7
adjudicada	8
revocada	18
suspendida	19
todos	Todos los estados

Órdenes de Compra — parámetro estado

Valor para ?estado=	Código en respuesta
enviadaproveedor	4
(sin query param)	5 (En proceso, solo en respuesta)
aceptada	6
cancelada	9
recepcionconforme	12
pendienterecepcion	13
recepcionaceptadacialmente	14
recepecionconformeincompleta	15
todos	Todos los estados

Formato de fecha

La API usa ddmmaaaa. Ejemplos: 07042026 → 7 de abril de 2026.

---

📦 Publicar en npm

npm login
npm publish   # ejecuta npm run build automáticamente (prepublishOnly)

---

🏗️ Estructura del proyecto

src/
├── main.ts                                           # Bootstrap (modo stdio)
├── app.module.ts
├── common/
│   └── constants/
│       └── api.constants.ts                          # BASE_URL, endpoints, códigos de estado
├── mercado-publico/
│   ├── interfaces/mercado-publico.interfaces.ts      # Tipos de parámetros
│   ├── helpers/query-builder.helper.ts               # Construcción de query params
│   ├── mercado-publico.service.ts                    # Cliente HTTP
│   └── mercado-publico.module.ts
└── mcp/
    ├── constants/tool-schemas.constants.ts           # Campos Zod reutilizables
    ├── tools/
    │   ├── licitaciones.tools.ts
    │   ├── ordenes-compra.tools.ts
    │   ├── empresas.tools.ts
    │   ├── estructura.tools.ts
    │   └── ayuda.tools.ts
    ├── mcp-server.ts
    ├── mcp.service.ts
    └── mcp.module.ts

---

⚠️ Limitación importante: archivos de licitaciones

Este MCP no tiene acceso a los archivos adjuntos de las licitaciones ni de las órdenes de compra (bases de licitación, anexos, especificaciones técnicas, resoluciones, etc.).

La API de Mercado Público no retorna links de descarga ni el contenido de los documentos. Solo expone los datos estructurados (metadatos) de cada proceso: montos, fechas, estados, ítems, organismos, etc.

Para acceder a los documentos debes ingresar directamente al portal: mercadopublico.cl

---

📝 Políticas y condiciones de uso de la API

Las limitaciones descritas a continuación no son impuestas por este servidor MCP, sino por la API oficial de Mercado Público (ChileCompra). Este servidor las respeta y documenta para que los usuarios las conozcan antes de usar el servicio.

Uso del ticket

• El ticket se solicita mediante formulario oficial seleccionando la opción "Solicitud de Ticket".
• Debe completarse con datos reales: nombre, apellido, RUT y correo electrónico.
• Se entrega un único ticket por persona. Datos inconsistentes pueden derivar en limitación o suspensión del acceso.
• ChileCompra usa los datos personales únicamente para operación, control y administración del servicio — no los comparte con terceros, salvo mandato judicial.

Límites de uso

• 10.000 solicitudes diarias por ticket — no modificable.
• El uso excesivo o abusivo puede derivar en suspensión temporal o bloqueo permanente.
• La API incluye validaciones por dirección IP: múltiples solicitudes desde la misma IP pueden generar restricciones.
• Para procesos de alta demanda o descarga masiva, usar horario nocturno (22:00–07:00 hrs, Chile).

Soporte

• Soporte únicamente a través del formulario de sugerencias del sitio web de ChileCompra.
• Plazo de respuesta: máximo 3 días hábiles.
• No se atienden solicitudes informales ni por correo institucional directo.

Responsabilidad

• La API es un servicio adicional y voluntario — ChileCompra puede modificarla, suspenderla o darla de baja sin previo aviso.
• ChileCompra no se hace responsable de la información publicada por terceros mediante aplicaciones que usen la API.
• Al publicar datos obtenidos desde la API sin modificarlos, debe indicarse que la fuente es la Dirección ChileCompra.

Documentación oficial: chilecompra.cl/api

---

🤝 Fuente de datos

Datos de Mercado Público, Dirección ChileCompra, Ministerio de Hacienda, Gobierno de Chile.