mcp-roldan-municipal

MCP + HTTP API read-only para consultas ciudadanas de Municipalidad de Roldán.

Qué hace

• Responde consultas ciudadanas con router por intención: reclamos, pagos, turnos, licencias, habilitaciones, obras, noticias/datos.

• Cita fuentes públicas oficiales y devuelve límites explícitos.

• Busca en un índice documental local generado desde páginas/PDFs oficiales (src/documentos-textos.ts).

• Expone MCP stdio para clientes compatibles.

• Expone HTTP/OpenAPI para ChatGPT Actions, web, n8n, Make, WhatsApp y demos.

• Incluye POST /webhook/consulta con reply listo para mensajería.

Related MCP server: bora-mcp

Qué NO hace

• No reserva turnos.

• No envía reclamos ni denuncias.

• No procesa pagos.

• No consulta deuda, expedientes ni datos personales.

• No reemplaza validación en la fuente oficial.

Instalar y verificar

npm install
npm run extract:docs
npm run typecheck
npm run build
npm run probe:fase1
npm run probe
npm run probe:http

HTTP local

ROLDAN_API_KEY=<tu-api-key> PORT=8787 npm run api:start

Endpoints

GET  /health
GET  /openapi.json
POST /consulta-ciudadana
POST /webhook/consulta
POST /fuentes/buscar
POST /fuentes/detalle
POST /noticias/buscar
POST /instructivos/buscar
POST /web/buscar
POST /reclamos/info
POST /pagos/info
POST /turnos/info
POST /tramites/info

Ejemplo búsqueda documental

curl -s https://<host>/instructivos/buscar \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ***' \
  -d '{ "consulta": "requisitos final de obra" }'

Devuelve fragmentos oficiales con fuente:

{
  "respuesta": "Encontré coincidencias...",
  "fuentes": [{ "titulo": "...", "url": "...", "tipo": "html/pdf", "metodo": "html/pymupdf" }],
  "limites": ["Validar vigencia en la fuente oficial enlazada."]
}

Ejemplo webhook n8n/WhatsApp

curl -s https://<host>/webhook/consulta \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ***' \
  -d '{
    "text": "Necesito hacer un reclamo por una luminaria rota",
    "channel": "whatsapp",
    "from": "+549****0000"
  }'

En n8n usar: ={ $json.reply }.

MCP

claude mcp add roldan -- node "$(pwd)/dist/src/index.js"

Tools principales:

consulta_ciudadana
buscar_instructivos
buscar_web_oficial
buscar_fuentes
detalle_fuente
buscar_noticias
reclamos_info
pagos_info
turnos_info
tramites_info

Fuentes y límites

• Catálogo oficial curado en src/fuentes.ts.

• Índice documental generado: 65 documentos/páginas oficiales.

• Roldán suma índice documental de 65 páginas/documentos oficiales y mantiene búsqueda viva por WordPress REST público.

• Fase 1.1: información pública read-only + índice documental + HTTP/OpenAPI + webhook de mensajería.

• Fase 2 futura: workflows autenticados sólo con autorización explícita, auditoría y guardrails.