Skip to main content
Glama
seace-mcp

seace-mcp

by pipaacebedo

Sistema Electrónico de Contrataciones del Estado - Seace (Conector MCP - No oficial)

Banner seace-mcp

Licencia Python MCP Local

Servidor MCP local para buscar y leer el SEACE — Sistema Electrónico de la Contratación del Estado (SEACE 3.0): procesos de selección, fichas de selección, documentos, contratos publicados y Plan Anual de Contrataciones — desde tu harness MCP. Sin navegador ni credenciales.

Herramienta no oficial: sin afiliación con el OECE ni el Estado peruano.

Aspecto

Detalle

Fuentes

Buscador Público SEACE 3.0 (procesos, fichas y documentos), API de contratos y PAC del mismo portal

Autenticación

Ninguna: todo el flujo es público

Almacenamiento

Ninguno — nunca guarda archivos: devuelve datos limpios y URLs de descarga

Transporte

stdio (Claude Desktop, Claude Code, agentes MCP)

Cómo funciona

  1. Buscador público — consulta los 6 buscadores (procesos, ACF, expresiones de interés, difusión de requerimientos, OCOS y CCO), pagina a demanda y navega a la ficha de selección con todo su detalle (items, cronograma, participantes, documentos).

  2. API de contratos — búsqueda, detalle completo, contratos por expediente, resumen georreferenciado y catálogos.

  3. PAC — Plan Anual de Contrataciones por entidad y año, con el detalle de los procesos programados.

  4. Documentos — URLs de descarga directa de PDF (nunca los baja ni los guarda).

Related MCP server: comprasal-mcp

Instalación

Opción A — Claude Desktop (un JSON)

  1. Instala uv.

  2. Añade a la configuración de servidores MCP:

{
  "mcpServers": {
    "seace": {
      "command": "uv",
      "args": ["--directory", "RUTA/seace-mcp-oss", "run", "seace-mcp", "serve"]
    }
  }
}

Opción B — Bundle (.mcpb)

  1. Descarga el asset seace-mcp.mcpb (nombre fijo, siempre la última versión) desde Releases.

  2. Instálalo según tu cliente:

    • Claude Desktop: Ajustes → Extensiones → Instalar desde archivo y elige el bundle.

    • Codex: extrae el bundle (es un archivo zip) y añade en ~/.codex/config.toml:

      [mcp_servers.seace]
      command = "uv"
      args = ["run", "--directory", "RUTA_EXTRAIDA", "server.py"]
    • Antigravity: extrae el bundle (es un archivo zip) y añade un servidor MCP local con command: uv y args: ["run", "--directory", "RUTA_EXTRAIDA", "server.py"]. Requiere tener uv instalado.

Actualizaciones

  • El servidor se auto-chequea en cada arranque: si publicamos una versión más nueva que la tuya, tu agente verá el aviso UPDATE DISPONIBLE y te pedirá descargar seace-mcp.mcpb de Releases e instalarlo de nuevo (como la primera vez). Se desactiva con SEACE_UPDATE_CHECK=0.

  • Cada versión reemplaza el mismo archivo (seace-mcp.mcpb): la página de Releases siempre muestra una sola tarjeta con la última.

Tools (25)

Tool

Qué hace

buscar_procesos

Procesos de selección de cualquier anio (filtros: descripcion, entidad, tipo, objeto, modalidad, SNIP, CUI)

buscar_acf

Anuncios de contratación futura

buscar_expresiones_interes

Expresiones de interés

buscar_requerimientos

Difusión de requerimientos

buscar_ocos

Órdenes de compra/servicio (anio + mes + RUC)

buscar_cco

Condiciones de contratación (contratos estandarizados)

buscar_entidades

Entidades por nombre/RUC/sigla

ficha_proceso

Ficha de selección: cabecera, items con CUBSO/MYPE/participantes, cronograma, documentos

detalle_item

Acciones por item del proceso (ciclo de vida)

historial_proceso

Historial de contrataciones por convocatoria

codigos_proceso

SNIP/CUI publicados del proceso

buscar_pac

Plan Anual de Contrataciones por entidad y anio

detalle_pac

Procesos programados del PAC (mes y fuente)

buscar_contratos

Contratos publicados (filtros acotadores server-side)

detalle_contrato

Ficha completa del contrato: items CUBSO, garantías, acciones, disputas, arbitrajes, documentos

contratos_expediente

Todos los contratos publicados de un expediente

fichas_procesos

Lote de fichas o resúmenes de procesos en una llamada (cap 8 completa / 50 resumen)

detalles_contratos

Lote de detalles de contratos en una llamada (cap 10)

resumen_georef

Resumen por departamento/anio y drill-down por objeto

catalogo_ubigeo

Departamentos, provincias y distritos

tipos_seleccion_contratos

Catálogo de tipos de selección de la API

url_documento

URL de descarga del PDF de un documento de proceso

url_documento_contrato

URL de descarga del documento de un contrato

url_perfil_proveedor

Perfil del proveedor en el portal OECE

listar_filtros

Valores exactos de los combos y catálogos

Cómo se usa (capas)

  1. Buscar — buscar_*: cada resultado lleva index global (continuo entre páginas), total y paginas. La página siguiente es una re-llamada con (ses, pagina) sin cambiar los filtros.

  2. Detalle — ficha_proceso(ses, index): cabecera, items, cronograma y documentos del proceso.

  3. Profundidad — detalle_item(ses, index, nro_item), historial_proceso(ses, index) y codigos_proceso(ses, index).

  4. Contratos — buscar_contratos → detalle_contrato(id_contrato); contratos_expediente(id_expediente); agregados con resumen_georef y catalogo_ubigeo.

  5. Documentos — url_documento(uuid), url_documento_contrato(id) y url_perfil_proveedor(ruc): devuelven URL, no archivos.

  6. PAC — buscar_pac(entidad, anio) y detalle_pac(entidad, anio).

Higiene de contexto: el servidor nunca recorta ni oculta información: cada respuesta contiene completo lo que el portal publica (el tamaño de página es 15, el del sitio; los agregados se acotan con nota explicando lo mostrado). Cuando necesites varios procesos o contratos a la vez, usa los lotes (fichas_procesos, detalles_contratos): una llamada con cap en vez de repetir la misma llamada.

Notas de uso

  • Las sesiones (ses) viven 15 minutos desde su última actividad (cada uso renueva el contador) y sirven para paginar y encadenar la profundidad; al vencer, el error lo indica con su pista.

  • La URL de descarga del PDF se firma al vuelo y tiene vigencia corta: descarga rápido tras obtenerla.

  • Ante entidades sin PAC publicado, la respuesta lo explica — no cuelga.

  • Un proceso de emergencia puede tener items vacíos (no es error).

  • Proyecto independiente, no oficial, sin relación con el OECE ni ninguna entidad del Estado peruano.

  • Sin garantía de disponibilidad del servicio upstream ni de exactitud de los textos; para uso serio, verifica siempre en la fuente oficial.

  • La información y datos provienen del portal del OECE.

Licencia

Apache-2.0

Available Tools

25 tools
buscar_acfBuscando anuncios de contratación futuraB

Busca ANUNCIOS DE CONTRATACION FUTURA (ACF) publicados por las entidades en el SEACE.

Args: objeto: tipo de objeto (OBLIGATORIO): Bien / Consultoria de Obra / Obra / Servicio. descripcion: texto del anuncio de contratacion futura. tipo: tipo de compra futura (ej 'Licitacion Publica'). entidad: entidad convocante. desde_pub: fecha inicial de publicacion dd/mm/aaaa. hasta_pub: fecha final de publicacion dd/mm/aaaa. desde_conv: fecha inicial de convocatoria aproximada dd/mm/aaaa. hasta_conv: fecha final de convocatoria aproximada dd/mm/aaaa. sigla: sigla de la entidad. pagina: numero de pagina (15 filas por pagina; 'index' global y continuo). paginas: paginas consecutivas a traer en una llamada (1..8). ses: sesion de una busqueda previa para pedir 'siguiente_pagina' o re-buscar; con filtros distintos la busqueda se re-ejecuta conservando el mismo 'ses' (no se emite id nuevo).

Devuelve: Igual que buscar_procesos; cada fila trae entidad, fecha_publicacion, tipo, objeto, descripcion, condiciones, nro_items, plazo_dias y fecha_aprox_conv.

Inputs: ses, tipo, sigla, objeto, +8 more.

buscar_ccoBuscando condiciones de contrataciónA

Busca CONDICIONES DE CONTRATACION del SEACE (contratos estandarizados de encargos y compras corporativas).

Args: anio: anio de la condicion (OBLIGATORIO; ej '2026'; valores en listar_filtros). objeto: tipo de objeto: Bien / Consultoria de Obra / Obra / Servicio. tipo: tipo de procedimiento CCO (ej 'Contratos Estandarizados'). pagina: numero de pagina (15 filas por pagina). paginas: paginas consecutivas a traer en una llamada (1..8). ses: sesion de una busqueda previa para pedir 'siguiente_pagina' o re-buscar; con filtros distintos la busqueda se re-ejecuta conservando el mismo 'ses' (no se emite id nuevo).

Devuelve: Filas con nro, fecha, entidad, descripcion, tipo, codigo, objeto e 'id_interno' (nidRequerimiento).

Inputs: ses, anio, tipo, objeto, +2 more.

buscar_contratosBuscando contratosA

Busca CONTRATOS PUBLICADOS en la API de contratos del SEACE. IMPORTANTE: la API no pagina y sin filtros trae el anio completo (~50k registros); pasa SIEMPRE un filtro acotador (texto, descripcion, proveedor, contrato, nomenclatura, expediente o entidad).

Args: anio: anio del contrato (OBLIGATORIO; ej '2026'). texto: palabra libre filtrada server-side (la mas efectiva; ej 'tuberia'). entidad: nombre o RUC de la entidad contratante. descripcion: texto dentro de la descripcion del contrato. proveedor: nombre o RUC del proveedor o consorcio. contrato: numero del contrato. proyecto: texto del proyecto de inversion. expediente: id del expediente (idExpediente de otro resultado). nomenclatura: nomenclatura del proceso (ej 'LP-SM-13-2025-SEDAPAL-1'). depa: departamento ('0' = todos). objeto: '0' todos, '62' Bien, '63' Consultoria, '64' Obra, '65' Servicio. cod_seleccion: codigo del tipo de seleccion (listar_filtros(categoria='tipos_contrato')). desde: fecha inicial de suscripcion dd/mm/aaaa. hasta: fecha final de suscripcion dd/mm/aaaa. maximo: filas a devolver (1..300).

Devuelve: {'ok', 'total_recibidos', 'mostrados', 'contratos': [{id_contrato, numero_contrato, descripcion, nomenclatura, id_expediente, entidad, ruc_entidad, contratista, ruc_contratista, consorcio, monto, monto_presupuesto, moneda, anio, fecha_suscripcion, fecha_inicio, fecha_fin, objeto, objeto_codigo, estado, id_documento}]}. Con 'id_documento' usa url_documento_contrato.

Inputs: anio (required), depa, desde, hasta, +11 more.

buscar_entidadesBuscando entidadesA

Busca ENTIDADES del Estado peruano en el buscador SEACE por nombre, RUC o sigla.

Args: nombre: texto del nombre de la entidad (ej 'SEDAPAL'). ruc: RUC exacto de 11 digitos. sigla: sigla de la entidad. ses: sesion previa opcional (GLOBAL y compartida entre tools; si se omite se abre una temporal).

Devuelve: {'ok', 'ses', 'total', 'filas': [{index, ruc, tipo_documento, nombre}]}. Usa el 'ruc' para buscar_ocos y el nombre exacto para buscar_procesos(entidad=...).

Inputs: ruc, ses, sigla, nombre.

buscar_expresiones_interesBuscando expresiones de interésA

Busca EXPRESIONES DE INTERES (EI) publicadas en el SEACE.

Args: objeto: tipo de objeto (OBLIGATORIO): Bien / Consultoria de Obra / Obra / Servicio. descripcion: texto de la expresion de interes (acota). nro_requerimiento: numero del requerimiento. desde: fecha inicial dd/mm/aaaa. hasta: fecha final dd/mm/aaaa. entidad: entidad convocante. sigla: sigla de la entidad. pagina: numero de pagina (15 filas por pagina; 'index' global y continuo). paginas: paginas consecutivas a traer en una llamada (1..8). ses: sesion de una busqueda previa para pedir 'siguiente_pagina' o re-buscar; con filtros distintos la busqueda se re-ejecuta conservando el mismo 'ses' (no se emite id nuevo).

Devuelve: Filas con {index (global), nro, entidad, numero, descripcion} + 'id_interno' (nidRequerimiento). Nota: el buscador de EI no expone fecha de publicacion ni monto por fila.

Inputs: ses, desde, hasta, sigla, +6 more.

buscar_ocosBuscando órdenes de compra y servicioA

Busca ORDENES DE COMPRA Y ORDENES DE SERVICIO (OC/OS) registradas en el SEACE.

Args: anio: anio de la orden (OBLIGATORIO; ej '2026'). mes: mes de la orden (OBLIGATORIO; '9' o 'setiembre'). ruc: RUC de la entidad o del contratista (OBLIGATORIO); hallalo con buscar_entidades. entidad: nombre exacto de la entidad (opcional). pagina: numero de pagina (15 filas por pagina). paginas: paginas consecutivas a traer en una llamada (1..8). ses: sesion de una busqueda previa para pedir 'siguiente_pagina' o re-buscar; con filtros distintos la busqueda se re-ejecuta conservando el mismo 'ses' (no se emite id nuevo).

Devuelve: Filas con nro, entidad, tipo_orden ('O/C' u 'O/S'), numero, objeto_descripcion, fecha_ini, fecha_fin, monto, ruc, entidad_rap, situacion y plazo.

Inputs: mes, ruc, ses, anio, +3 more.

buscar_pacBuscando PACA

Busca en los PLANES ANUALES DE CONTRATACIONES (PAC) publicos del SEACE por ENTIDAD y anio. Cada fila trae la entidad, su ubigeo, ultima version del PAC, cantidad de procesos programados y el valor agregado en Soles.

Args: entidad: nombre o parte del nombre de la entidad (ej 'SEDAPAL'). Requerida: el buscador del PAC obliga a elegir institucion o ubigeo. anio: anio del PAC (ej '2026'; el catalogo del sitio ofrece 2019..2026).

Devuelve: {'ok', 'entidad', 'anio', 'total', 'filas': [{item, entidad, ubigeo, ultima_version, cantidad_procesos, valor_proceso_soles}]}. Con detalle_pac(...) bajas el listado de procesos programados.

Inputs: entidad (required), anio.

buscar_procesosBuscando procesosA

Busca PROCESOS DE SELECCION en el Buscador Publico del SEACE (licitaciones, adjudicaciones abreviadas, comparaciones de precios, etc). POLITICA DE SESION: para continuar una busqueda en la pagina siguiente, re-llama con el MISMO 'ses' y la 'pagina' pedida sin repetir los filtros (o repitiendolos identicos); si envias filtros distintos inicia una busqueda nueva.

Args: anio: anio de la convocatoria (OBLIGATORIO en la primera llamada; ej '2026'); sin otros filtros devuelve los procesos mas recientes de ese anio. descripcion: texto libre del objeto de contratacion (ej 'material electrico'); el buscador filtra server-side. entidad: nombre o parte del nombre de la entidad convocante. tipo: tipo de seleccion exacto (ej 'Licitacion Publica'); valores en listar_filtros. objeto: Bien / Consultoria de Obra / Obra / Servicio. modalidad: modalidad de seleccion (ej 'Acuerdo Marco'). departamento: departamento de la entidad (ej 'LIMA'). version: 'Seace 3' (se envia '3' al filtro). nro_seleccion: numero de seleccion (sin nomenclatura). numero_convocatoria: numero de convocatoria (ej '1'). snip: codigo SNIP. cui: codigo unico de inversion (CUI). sigla: sigla de la entidad. pagina: numero de pagina (15 filas por pagina; 'index' es GLOBAL y continuo entre paginas; SIN 'ses' sirve la pagina N de una busqueda NUEVA). paginas: paginas consecutivas a traer en una llamada (1..8). ses: sesion de una busqueda previa para pedir 'siguiente_pagina' o re-buscar; con filtros distintos la busqueda se re-ejecuta conservando el mismo 'ses' (no se emite id nuevo).

Devuelve: {'ok', 'ses', 'tab', 'tamano_pagina', 'total', 'paginas', 'pagina', 'siguiente_pagina', 'filas': [{index (global 0-based), nro, entidad, fecha_publicacion, nomenclatura, objeto, descripcion, monto ('Reservado' o '---': ambos indican monto no publicado), moneda, version, campos (fila cruda sin JS)}]}. Los 'index' se usan con ficha_proceso.

Inputs: cui, ses, anio, snip, +12 more.

buscar_requerimientosBuscando requerimientosA

Busca en la DIFUSION DE REQUERIMIENTOS del SEACE (bienes y servicios que las entidades requeriran).

Args: objeto: tipo de objeto (OBLIGATORIO): Bien / Consultoria de Obra / Obra / Servicio. descripcion: texto del bien o servicio requerido (acota). nro_requerimiento: numero del requerimiento. desde: fecha inicial dd/mm/aaaa. hasta: fecha final dd/mm/aaaa. entidad: entidad convocante. sigla: sigla de la entidad. pagina: numero de pagina (15 filas por pagina; 'index' global y continuo). paginas: paginas consecutivas a traer en una llamada (1..8). ses: sesion de una busqueda previa para pedir 'siguiente_pagina' o re-buscar; con filtros distintos la busqueda se re-ejecuta conservando el mismo 'ses' (no se emite id nuevo).

Devuelve: Filas con {index (global), nro, entidad, numero, descripcion} + 'id_interno' (nidRequerimiento). Nota: el buscador de difusion no expone fecha de publicacion ni monto por fila.

Inputs: ses, desde, hasta, sigla, +6 more.

catalogo_ubigeoListando catálogo de ubigeosA

Catalogo geografico de la API de contratos del SEACE: departamentos, provincias y distritos (llena 'depa' en buscar_contratos y resumen_georef).

Args: nivel: 'depas' (lista completa), 'provi' (provincias de un departamento) o 'distri' (distritos de una provincia). id: codigo del nivel padre; OBLIGATORIO con 'provi' (codigo de departamento ej '19' Pasco) y con 'distri' (codigo de provincia ej '2503').

Devuelve: {'ok', 'nivel', 'catalogo': [{codigo, nombre}], 'nota'}: los codigos 'codigo' se usan como 'depa'/'id' en las otras tools.

Inputs: id, nivel.

codigos_procesoLeyendo códigos SNIP/CUIA

CODIGOS SNIP/CUI asociados a un proceso (ses, index de buscar_procesos) desde el popup 'Codigos' del buscador.

Args: ses: sesion devuelta por buscar_procesos. index: 'index' global de la fila de esa busqueda (0-based).

Devuelve: {'ok', 'ses', 'index', 'filas': [codigos...]}; 'filas' vacio cuando el proceso no publica CUI (el sitio muestra 'Sin informacion').

Inputs: ses (required), index (required).

contratos_expedienteLeyendo contratos del expedienteA

Todos los CONTRATOS publicados de un expediente de seleccion (un proceso puede tener varios contratos).

Args: id_expediente: id del expediente de seleccion ('id_expediente' de buscar_contratos; ej '1171246').

Devuelve: {'ok', 'id_expediente', 'total', 'contratos': [{id_contrato, numero_contrato, ...}]}: con 'id_contrato' usa detalle_contrato.

Inputs: id_expediente (required).

detalle_contratoObteniendo detalle del contratoA

Detalle COMPLETO de un contrato publicado de la API JSON del SEACE: cabecera, items con CUBSO, garantias, acciones (penalidades/adicionalidades con documento), proyectos de inversion, disputas, conciliaciones y arbitrajes, y los documentos con su URL de descarga.

Args: id_contrato: 'id_contrato' de buscar_contratos o contratos_expediente (ej '2377490').

Devuelve: {'ok', 'cabecera', 'items', 'garantias', 'acciones', 'documentos': [{id_documento, url, archivo, tamano_kb, fecha}], 'proyectos'|'disputas'|'conciliaciones'|'arbitrajes' (si hay)}: las URLs son descarga directa del PDF (sin token).

Inputs: id_contrato (required).

detalle_itemLeyendo acciones del ítemA

ACCIONES REALIZADAS POR ITEM de un proceso (ses, index de buscar_procesos, nro_item 1-based de ficha_proceso -> items).

Args: ses: sesion devuelta por buscar_procesos. index: 'index' global de la fila de esa busqueda (0-based). nro_item: numero del item (1-based; el orden de 'items' en ficha_proceso).

Devuelve: {'ok', 'url', 'cabecera' (mapa de pares opcionales), 'item': {nro_item, descripcion_item}, 'acciones': [{nro, situacion, fecha_publicacion, motivo}]}: el ciclo de vida completo del item (publicacion de convocatoria, adjudicado, contrato, etc).

Inputs: ses (required), index (required), nro_item (required).

detalle_pacLeyendo programación del PACA

LISTADO DE PROCESOS PROGRAMADOS del PAC de la entidad (busca en el PAC por entidad/anio y baja el detalle): cada fila trae el proceso programado con su mes y fuente de financiamiento.

Args: entidad: nombre de la entidad (igual que buscar_pac). anio: anio del PAC. index: fila del resultado de buscar_pac (0-based; normalmente 0).

Devuelve: {'ok', 'ses', 'procesos': [{nro, entidad, objeto_descripcion, tipo_compra, nro_convocatoria, mes_programado, fuente_financiamiento}]}: el plan anual completo de la entidad.

Inputs: entidad (required), anio, index.

detalles_contratosObteniendo contratos en loteA

Lote de DETALLES de contratos publicados en UNA llamada (evita repetir detalle_contrato por cada id).

Args: ids: lista de 'id_contrato' numericos (ej ['2377490']; duplicados se procesan una sola vez; cap: 10 por llamada). maximo: tope de detalles por llamada (1..10).

Devuelve: {'ok', 'detalles': [{ok, cabecera, items, acciones, documentos...}], 'faltas': [{id_contrato, error}], 'nota'}: cada elemento trae los mismos campos de detalle_contrato con su 'ok' individual; los ids no numericos van a 'faltas' y el resto se procesa; usa detalle_contrato si solo necesitas uno.

Inputs: ids (required), maximo.

ficha_procesoObteniendo ficha del procesoA

FICHA DE SELECCION de un proceso del SEACE: cabecera completa, items, cronograma y documentos.

Args: ses: sesion devuelta por buscar_procesos. index: 'index' de la fila de esa busqueda (0-based).

Devuelve: {'ok', 'url_ficha', 'cabecera': mapa de pares etiqueta/valor normalizados con campos OPCIONALES (pagina_web, telefono, cui, causal, monto_del_costo... aparecen solo cuando el proceso los publica), 'items': [{nro_item, item (denominacion), cubso, cantidad, reserva_mype, paquete, monto_contratacion, estado, postor, monto_adjudicado (si adjudicado)}], 'cronograma': [{actividad, inicio, fin}], 'documentos': [{nro, etapa, documento, uuid, archivo, tamano_kb, fecha}]}. Usa url_documento(uuid) para la URL firmada del PDF. Nota: los procesos de emergencia o sin items poblados pueden traer 'items' vacio.

Inputs: ses (required), index (required).

fichas_procesosObteniendo fichas en loteA

Lote de fichas o resumenes de procesos de la MISMA busqueda, en UNA llamada (evita repetir ficha_proceso por cada index).

Args: ses: sesion devuelta por buscar_procesos. indices: 'index' globales (0-based) de esa busqueda (ej [0, 1, 2]; duplicados se procesan una sola vez; cap: 50 con 'resumen', 8 con 'completa'). profundidad: 'resumen' trae la fila del buscador (entidad, nomenclatura, objeto, monto, fechas, version); 'completa' trae la ficha entera (items, cronograma, documentos) como ficha_proceso.

Devuelve: {'ok', 'ses', 'profundidad', 'fichas': [...], 'faltas': [{index, motivo}], 'nota'}: los indices fallidos van a 'faltas' con su motivo y el resto se entrega; usa ficha_proceso individual si solo necesitas una.

Inputs: ses (required), indices (required), profundidad.

historial_procesoLeyendo historial del procesoA

HISTORIAL DE CONTRATACIONES del proceso (ses, index de buscar_procesos): cada convocatoria de la contratacion con su etapa y estado.

Args: ses: sesion devuelta por buscar_procesos. index: 'index' global de la fila de esa busqueda (0-based).

Devuelve: {'ok', 'url', 'cabecera': mapa de pares (entidad, nomenclatura, nro_convocatoria, objeto, ...), 'historial': [{nro, nomenclatura, etapa, estado}]}.

Inputs: ses (required), index (required).

listar_filtrosListando filtrosA

Valores exactos de los combos del buscador SEACE y catalogos de la API JSON de contratos.

Args: categoria: 'todos' (resumen por buscador), 'anio', 'mes', 'objeto', 'tipo_seleccion', 'modalidad', 'departamento', 'version', 'encargo' (combos del buscador JSF) o 'tipos_contrato' (catalogo de la API con 'codSeleccion' para buscar_contratos). ses: sesion opcional de una busqueda previa (reutiliza la pagina cacheada; si se omite se abre una temporal). La sesion es GLOBAL y compartida entre tools.

Devuelve: {'ok': True, 'combos': {categoria: {buscador: {total, ejemplos (primeros 12): [...]}}}} o, para 'tipos_contrato', {'ok': True, 'codigos': [{codSeleccion, descSeleccion}]}. Nota: el buscador CCO solo ofrece anios recientes (2024-2026, dato del sitio).

Inputs: ses, categoria.

resumen_georefResumiendo contrataciones por regiónA

Resumen GEOreferenciado de contratos publicados de un departamento y anio. Sin 'objeto': cuantos contratos y monto acumulado por tipo de objeto (Bien/Consultoria/Obra/Servicio). Con 'objeto': la lista de contratos de ese departamento, anio y objeto (drill-down, mismos campos que buscar_contratos).

Args: anio: anio del resumen (ej '2026'). depa: codigo del departamento del catalogo_ubigeo (ej '19' Pasco). objeto: codigo del tipo de objeto del drill-down ('62' Bien, '63' Consultoria, '64' Obra, '65' Servicio).

Devuelve: {'ok', 'anio', 'depa', 'resumen': [{tipo_objeto, cantidad, total_soles}], 'nota'} o, con 'objeto', {'ok', 'contratos': [...], 'total_recibidos', 'mostrados', 'nota'}: para la ficha del contrato usa detalle_contrato. El drill-down con 'objeto' no pagina y se recorta a los primeros 100 contratos ('mostrados'); para el resto usa buscar_contratos con depa+objeto.

Inputs: anio (required), depa (required), objeto.

tipos_seleccion_contratosListando tipos de selecciónA

Catalogo EXACTO de tipos de seleccion de la API JSON de contratos.

Args: anio: anio del catalogo (ej '2026').

Devuelve: {'ok', 'tipos': [{codSeleccion, descSeleccion}]}: 'codSeleccion' es el valor de 'cod_seleccion' en buscar_contratos.

Inputs: anio.

url_documentoResolviendo URL del documentoA

Devuelve la URL firmada para descargar un DOCUMENTO de proceso del SEACE (bases integradas, integraciones, etc).

Args: uuid: 'uuid' del documento listado en ficha_proceso (ej 'ac1aedfc-230d-4e50-9756-bb2fe1f1a4f7').

Devuelve: {'ok', 'url', 'archivo'}: 'url' es el enlace directo del PDF, firmado al vuelo y con vigencia corta; el servidor NO descarga el archivo. Nota: ante un uuid inexistente el servicio puede no responder y el error se reporta como timeout; distinguelo del uuid malformado, que se rechaza al instante.

Inputs: uuid (required).

url_documento_contratoResolviendo URL del documento de contratoB

URL de descarga del documento de un CONTRATO de la API JSON del SEACE.

Args: id_documento: 'id_documento' del contrato (idDocumentoContrato; ej '153203160').

Devuelve: {'ok', 'url', 'nota'}: GET directo del PDF; el servidor no lo guarda.

Inputs: id_documento (required).

url_perfil_proveedorResolviendo URL del perfil de proveedorB

URL del PERFIL del proveedor en el portal del OECE (perfilprov).

Args: ruc: RUC del proveedor o consorcio.

Devuelve: {'ok', 'url'}: pagina publica del perfil del proveedor.

Inputs: ruc (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 25 tools

    Disambiguation4/5

    Each buscar_* tool targets a distinct SEACE dataset (processes, ACF, EI, requirements, OC/OS, CCO, entities, PAC, contracts), and detail tools are split into individual vs batch with explicit guidance. Minor overlap exists between buscar_expresiones_interes and buscar_requerimientos because their result shapes are similar, and between ficha_proceso and fichas_procesos, but descriptions clarify when to use each.

    Naming Consistency3/5

    Naming is readable and grouped (buscar_*, detalle_*, fichas_*), but it mixes verb-first search tools with noun-first detail/catalog tools and inconsistent singular/plural forms (ficha_proceso vs fichas_procesos, detalle_contrato vs detalles_contratos). It is not chaotic, but it does not follow one predictable verb_noun pattern throughout.

    Tool Count3/5

    25 tools is borderline heavy for the server's broad domain, spanning processes, contracts, PAC, georef, catalogs, and document URLs. Most tools earn their place, but the volume increases selection cost and could be streamlined with fewer parameterized endpoints.

    Completeness4/5

    Coverage is strong across search and detail for processes, ACF, EI, requirements, orders, contracts, PAC, entities, ubigeo, and documents, including batch helpers. Minor gaps remain, such as no general provider search beyond contract filters or profile URL, but core procurement workflows are well supported.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for Peruvian public-data lookups including SUNAT RUC registrations, BCRP exchange rates, and SEACE tenders. Provides official open-data access through tools for Claude, Cursor, and other MCP clients.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables querying El Salvador's public procurement data, including awarded processes, supplier contracts, and institution details, from the live COMPRASAL API through an MCP interface.
      8
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables access to Chile's government procurement data (Mercado Público / ChileCompra) via MCP, allowing AI agents to query public procurement information.
      95 npm
      MIT