elPeruanoMCP
You can search, read, and retrieve public documents from El Peruano via a local MCP server without storing any files.
Full-text search dispositivos and cuadernillos with filters by cuadernillo, sector post-filter, date, date range, and pagination.
Look up a specific dispositivo by OP number.
Fetch a dispositivo's metadata, integral text, PDF URL, and thumbnail.
Fetch a dispositivo's text by paragraph ranges.
Read or search inside cuadernillo PDFs by page range or text query.
List cuadernillos by date or up to 7-day range, optionally filtered by type.
Get public PDF download URLs for dispositivos and cuadernillos; the server never downloads or stores them.
List publication types and identify which have individual dispositivos.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@elPeruanoMCP busca normas legales sobre minería en julio de 2026"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Búsquedas El Peruano (Conector MCP - No oficial)

Servidor MCP local para buscar y leer el Diario Oficial El Peruano (normas, resoluciones, cuadernillos y PDFs) desde tu harness MCP.
Herramienta no oficial: sin afiliacion con EL PERUANO y sin aceptacion de contribuciones externas. Ver Aviso legal.
Fuente de datos | busquedas.elperuano.pe (publico) |
Almacenamiento | Ninguno — el servidor nunca guarda archivos; los PDFs se entregan como URL |
Herramientas | 9 |
Instalacion
Opcion 1: .mcpb (one-click, Claude Desktop)
Descarga el asset
elPeruanoMCP.mcpb(nombre fijo, siempre la ultima version) de la seccion Releases.En Claude Desktop: Ajustes > Extensiones > instalar desde archivo, y selecciona el
.mcpb.Claude Desktop se encarga del entorno y las dependencias por ti.
Related MCP server: CREG MCP Server
Actualizacion
El servidor se auto-chequea en cada arranque: si publicamos una version mas nueva que la tuya, tu agente vera el aviso
UPDATE DISPONIBLEy te pedira descargarelPeruanoMCP.mcpbde Releases e instalarlo de nuevo (arrastralo como la primera vez). Se desactiva conEPERUANO_UPDATE_CHECK=0.Cada version reemplaza el mismo archivo (
elPeruanoMCP.mcpb): la pagina de Releases siempre muestra una sola tarjeta con la ultima.
Opcion 2: uv (recomendada para desarrolladores)
Clona el repo:
git clone https://github.com/pipaacebedo/elPeruanoMCPEntra a la carpeta:
cd elPeruanoMCPInstala las dependencias:
uv syncLanza el servidor:
uv run elperuano-mcp serve
Opcion 3: pip (sin uv)
Instala el paquete:
pip install .Lanza el servidor:
elperuano-mcp serve
Conectar el cliente
Claude Code:
claude mcp add elPeruanoMCP -- uv --directory RUTA/elPeruanoMCP run elperuano-mcp serveChatGPT: seccion MCP/connectors de tu setup (config equivalente)
Otros harness: config MCP equivalente (command + args)
"mcpServers": {
"elPeruanoMCP": {
"command": "uv",
"args": ["--directory", "RUTA/elPeruanoMCP", "run", "elperuano-mcp", "serve"]
}
}Al ser local, no hay autenticacion, tokens ni limites de ningun tipo.
Herramientas
Tool | Uso |
| Busqueda full-text con filtros (cuadernillo, sector post-filtro, fecha, rango) y paginacion deduplicada |
| Puntual por numero de orden (NNNNNNN-N); devuelve campos planos |
| Sumilla, tipo, numero, sector, fechas, texto integral (+ rango |
| Texto por parrafos en rangos, con metadatos del dispositivo |
| Lee el PDF del cuadernillo en memoria: busca texto dentro del PDF ( |
| Cuadernillos por fecha o rango (max 7 dias), con filtro por tipo y |
| Devuelven la URL publica del PDF (no descargan nada) |
| Siglas y cuales tipos tienen dispositivos individuales |
Como consultar
Necesitas | Como |
Frase exacta | Entre comillas dobles: |
Tema que cae en cuadernillos (PC/DJ/JU/CA) |
|
Puntual por OP |
|
Un dia puntual |
|
Un rango |
|
Solo Normas Legales |
|
Variables de entorno (opcionales)
Variable | Default | Para que |
|
| Origen de los datos |
|
| Timeout HTTP |
|
| Cache en memoria (0 = off) |
|
| Presupuesto de cache por bytes |
|
| No cachear paginas mayores a esto |
|
| Tope de paginas por llamada |
|
| Requests simultaneos hacia el sitio |
Limitaciones y diseno
Aspecto | Detalle |
Filtros web Entidad/Tipo de dispositivo | No aplican server-side: incluye el organismo en |
| Contador de coincidencias de texto del sitio (no dispositivos unicos); |
PC/DJ/JU/CA/IN/TU | Sin dispositivo individual: el texto integral vive en el PDF del cuadernillo ( |
Streaming | Paginas de busqueda se leen con corte en |
Cortesia | Cache por bytes + single-flight + semaforo de concurrencia para no sobrecargar la fuente oficial |
Latencia | Busquedas sin filtro de cuadernillo pueden tardar 10-40 s (el sitio genera la pagina completa) |
Aviso legal
Herramienta de terceros no oficial, sin afiliacion con EL PERUANO ni con ninguna entidad publica.
Provista tal cual; el autor no responde por el uso que se le de ni por la disponibilidad del sitio.
Los datos son de acceso publico en busquedas.elperuano.pe; respeta la fuente: no la uses para scraping masivo.
Proyecto personal: no se aceptan contribuciones externas ni se ofrece soporte. Puedes forkarlo y adaptarlo a tu criterio.
Licencia
Available Tools
9 toolsbuscar_dispositivosBuscando dispositivosA
Busca dispositivos y cuadernillos en El Peruano.
Args:
consulta: texto libre; frases exactas entre comillas dobles, ej: '"prescripcion adquisitiva de dominio"'. El sitio combina palabras por coincidencia de texto y no garantiza un AND estricto entre todas.
cuadernillo: sigla del tipo de publicacion (ver listar_tipos_publicacion): NL, BO, EX, PC, DJ, JU, SE, CA, IN, TU. Opcional.
sector: post-filtro por subcadena sobre el campo sector de los resultados obtenidos (ej: "salud"). NO filtra todo el corpus: solo la pagina(s) de resultados actual.
fecha: dia puntual YYYYMMDD.
fecha_ini, fecha_fin: rango de fechas YYYYMMDD.
start: desplazamiento de resultados (pagina N -> start = N*20).
paginas: paginas consecutivas a traer en una sola llamada (1 = 20 resultados).
Nota de latencia: sin filtro de cuadernillo, el sitio puede tardar 10-40 s en generar la respuesta (con filtro NL/BO es mas rapido). El sitio pagina por coincidencias de texto y puede repetir dispositivos entre paginas: usa paginas (deduplica internamente) en lugar de start manual.
Devuelve: coincidencias_texto: contador del sitio (coincidencias de texto, no dispositivos unicos). dispositivos_unicos: cantidad de dispositivos individuales devueltos. ms: duracion de la llamada en milisegundos. data: dispositivos con pagina individual (sector, tipo, numero, fecha, titulo, url). cuadernillos_con_coincidencias: cuando las coincidencias caen en cuadernillos SIN pagina individual (PC/DJ/JU/CA/IN/TU) el resultado son cuadernillos (compacto): codigo, fecha, paginas y pdf_url; el texto integral esta en el PDF. siguiente_start: start para la proxima pagina, si hay mas. cacheado: true si la respuesta vino de la cache de resultados. sin_resultados_motivo + nota: cuando no hay resultados, con la causa y sugerencias.
Inputs: fecha, start, sector, paginas, +4 more.
buscar_por_opBuscando por orden de publicaciónC
Busqueda puntual por numero de orden de publicacion (OP).
Args: op: formato NNNNNNN-N, ej '2558398-1'.
Inputs: op (required).
descargar_cuadernilloResolviendo URL del cuadernilloA
URL de descarga del PDF completo de un cuadernillo.
Es la unica via de texto para cuadernillos SIN dispositivo individual (PC/DJ/JU/CA/IN/TU). El MCP no descarga ni guarda: devuelve la URL publica para el cliente.
Devuelve tambien url_viewer (pagina visor del cuadernillo). Nota: el sitio publica el archivo con nombres con sufijo de pagina inicial (ej PC20260606_4335.pdf); otras URLs del mismo cuadernillo (sin sufijo) tambien sirven el mismo PDF.
Args: codigo: codigo TIPO+FECHA, ej 'NL20230923' o 'PC20260927'.
Inputs: codigo (required).
descargar_pdfResolviendo URL del PDFA
URL de descarga del PDF de un dispositivo individual.
El MCP NUNCA almacena archivos: devuelve la URL publica en busquedas.elperuano.pe para que el usuario descargue por su cuenta.
Args: cuadernillo: sigla de publicacion (ver listar_tipos_publicacion). op: numero de orden, ej '2558398-1'.
Inputs: op (required), cuadernillo (required).
listar_cuadernillosListando cuadernillosA
Lista cuadernillos publicados en una fecha o rango (con pdf_url).
Args: fecha: YYYYMMDD, AAAA-MM-DD o DD/MM/AAAA (vacio = los ultimos publicados). fecha_fin: opcional; con fecha, recorre el rango hasta esta fecha (maximo 7 dias INCLUSIVE por llamada). tipo: filtro por sigla de los cuadernillos listados (ej "NL").
Inputs: tipo, fecha, fecha_fin.
listar_tipos_publicacionListando tipos de publicaciónA
Siglas de cuadernillos (tipoPublicacion) y sus titulos.
PC/DJ/JU/CA/IN/TU no tienen dispositivo individual; para esos la busqueda devuelve cuadernillos_con_coincidencias y el texto integral solo vive en el PDF del cuadernillo (descargar_cuadernillo).
Inputs: no named parameters.
obtener_cuadernillo_textoLeyendo el texto del cuadernilloA
Busca texto DENTRO del PDF de un cuadernillo (query) o lee su texto por paginas, en rangos controlados.
Es la unica via de lectura del texto integral para cuadernillos SIN pagina individual (PC/DJ/JU/CA/IN/TU): el PDF se descarga en memoria y se procesa pagina por pagina; nunca se guarda en disco.
Args: codigo: codigo TIPO+FECHA, ej 'PC20260927'. pagina_desde, pagina_hasta: rango de paginas del PDF (1-indexed, inclusivo). Maximo 10 paginas por llamada. query: opcional; texto a buscar en TODAS las paginas del PDF (case-insensitive). Si se indica, el resultado son las paginas que contienen el texto, con extractos de contexto (ignora pagina_desde/pagina_hasta). Para PDFs de cientos de paginas.
Inputs: codigo (required), query, pagina_desde, pagina_hasta.
obtener_dispositivoObteniendo dispositivoA
Devuelve el dispositivo completo: sumilla, tipo, numero, sector, fechas y texto integral, mas pdf_url y thumbnail.
Nota: el texto integral puede ser muy largo. Para documentos extensos usa obtener_dispositivo_texto (rangos de parrafos) o limita aqui con desde/hasta.
Args: cuadernillo: sigla de publicacion (ver listar_tipos_publicacion). Opcional: si se omite, se auto-resuelve por OP. op: numero de orden, ej '2558398-1'. desde, hasta: opcionales; rango de parrafos 1-indexed (inclusivo). Vacios = texto completo.
Inputs: op, desde, hasta, cuadernillo.
obtener_dispositivo_textoLeyendo el texto del dispositivoA
Texto de un dispositivo por parrafos, en dosis controladas (para documentos largos sin saturar el contexto).
Incluye los metadatos del dispositivo (sumilla, tipo, numero, sector, fecha). Sin tope de parrafos: usa rangos razonables.
Args: cuadernillo: sigla de publicacion. Opcional: si se omite, se auto-resuelve por OP. op: numero de orden. desde, hasta: rango de parrafos (1-indexed, inclusivo).
Inputs: op, desde, hasta, cuadernillo.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Most tools have distinct purposes: buscar_por_op is a targeted OP lookup while buscar_dispositivos is free-text search, and descargar_pdf vs descargar_cuadernillo target different resources. The one soft overlap is obtener_dispositivo vs obtener_dispositivo_texto (both return device text), but the descriptions explicitly state when to use the paragraph-ranged variant.
All tools follow a consistent Spanish verb_noun snake_case pattern: buscar_*, obtener_*, listar_*, descargar_*. No mixing of conventions, and names clearly telegraph the action and target resource.
Nine tools is well-scoped for a read-only gazette access server, covering search, retrieval, listing, and download without redundancy. Each tool earns its place, no bloat.
The surface covers the full read lifecycle: search by OP and free text, fetch device/full text, list publication types and cuadernillos, and obtain device/cuadernillo PDF URLs plus in-PDF text search. Minor gaps (e.g. no sector-wide corpus filtering, only page-level post-filter) are documented workarounds rather than dead ends.
Maintenance
Related MCP Connectors
Official MCP connector for Legalize: read and search its whole open corpus, at any point in time.
Colombian, Peruvian, and Mexican public data: judicial cases, registries, legislation, web search.
Public Indian legal search MCP for Roop judgments, statutes, and corpus grounding.
Resolve, search and verify legal citations against the official sources, with provenance.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for searching and extracting official announcements, decrees, and resolutions from the Argentine Official Gazette (Boletín Oficial de la República Argentina). It enables LLMs to perform real-time searches and retrieve verbatim legal text with complete juridical fidelity.1419 npm3MIT
- AlicenseAqualityCmaintenanceEnables MCP clients to search Colombian energy and gas resolutions and legal opinions, read them in chunks or by internal search, and explore each rule's regulatory graph with validity computed from the texts themselves.4MIT
- AlicenseAqualityBmaintenanceEnables local MCP clients to search and read Peru's official legal information system, including legal norms and jurisprudence, with tools for full-text search, structure mapping, targeted reading, and filters. It provides clean content without storing files, using stdio transport and public session authentication.76Apache 2.0
- AlicenseAqualityBmaintenanceEnables local, credential-free searching and reading of Peru's public procurement system—including selection processes, contracts, documents, and annual procurement plans—through MCP tools, returning clean data and direct download URLs without storing files.251Apache 2.0