Skip to main content
Glama

laspalmas-avisos-mcp

Servidor MCP (y CLI de apoyo) para el sistema de avisos del Ayuntamiento de Las Palmas de Gran Canaria (LPGC Tu Ciudad / LPGC Avisa). Permite a un agente listar servicios y categorías, consultar avisos y crear avisos con inteligencia artificial — incluso desde una foto. La clave de app va integrada (es la de la propia app, pública en el APK).

La finalidad de este proyecto es hacer más fácil que los ciudadanos puedan reportar problemas al Ayuntamiento. Saca una foto de la incidencia (una papelera llena, una acera rota, una farola apagada…), pásasela al agente pidiéndole que genere un aviso para que describa el problema, seleccione servicio y categoría, añada la ubicación y lance el aviso al Ayuntamiento.

Inicio rápido

Las Palmas no usa cuentas: el API acepta la clave fija de la app y cada aviso lleva el email y teléfono del comunicante.

  1. Añade el servidor a tu cliente MCP (ejemplos) o configúralo a mano:

{
  "mcpServers": {
    "laspalmas-avisos": {
      "command": "npx",
      "args": ["-y", "laspalmas-avisos-mcp"]
    }
  }
}
  1. Verifica: list_services debe devolver los 11 servicios.

  2. Pregunta al humano UNA vez su email (y teléfono) y guárdalos con la tool set_identity. Se reutilizan en todos los avisos.

  3. Flujo del agente: create_aviso_from_photo (foto → categoría → preview) → enseña el preview al humano → confirm: true + human_confirmed: true + preview_token solo con su "sí".

Todo corre en tu máquina; los avisos se crean con la identidad guardada.

Related MCP server: valencia-avisos-mcp

Fotos demasiado grandes para el modelo

Algunos modelos rechazan fotos muy grandes (image decode limit exceeded). El servidor reduce en TypeScript (sin dependencias) conservando el GPS, así que el modelo nunca necesita procesar la original:

  • Remoto (HTTP): sube la foto con curl y usa el file_id (los bytes no pasan por el modelo). Requiere el secreto del servidor:

    curl -X PUT --data-binary @foto.jpg \
      -H "Authorization: Bearer ***" \
      'http://127.0.0.1:3003/upload?filename=foto.jpg'
    # → {"file_id":"…","bytes":…}

    El preview devuelve preview_image_base64 (copia reducida) para visión y el envío usa siempre la original en base64.

  • Local (stdio/CLI): pasa image_path; el servidor lee y reduce sin que el modelo abra el fichero. O reduce tú con node dist/cli.js prep-photo foto.jpg [foto-ligera.jpg].

¿Eres un agente IA? Lee esto primero

La skill (skill/SKILL.md) no se autoinstala: cópiala al directorio de tu cliente y abre sesión nueva.

cp -r skill ~/.hermes/skills/laspalmas-avisos        # Hermes
cp -r skill ~/.claude/skills/laspalmas-avisos        # Claude Code
# o descárgala: https://github.com/Naroh091/laspalmas-avisos-mcp/blob/main/skill/SKILL.md

Instálalo así (requiere Node 18+):

  1. Sin credenciales: este MCP no necesita tokens ni cuentas. Solo el email y teléfono del humano (paso 3 del inicio rápido).

  2. Instalación según tu cliente (comandos exactos): Claude Code (claude mcp add … -- npx -y laspalmas-avisos-mcp), Hermes (hermes mcp add … --command npx … --args -y laspalmas-avisos-mcp) u OpenClaw (openclaw mcp add … --command npx --arg -y --arg laspalmas-avisos-mcp).

  3. Identidad: pregunta email y teléfono UNA vez y guárdalos con set_identity (verifica con get_identity).

  4. Verifica (mcp list / test / doctor --probe según cliente): debes ver 8 tools.

  5. Uso: hay skill completa en skill/SKILL.md. Lo esencial: solo incidencias genuinas; create_aviso_from_photo en fases (categoría → preview → envío solo con "sí" humano + confirm + human_confirmed + preview_token); foto por file_id; la dirección es texto libre y las coordenadas van en el aviso.

Añadir el MCP vía npx

Requiere Node 18+.

Claude Code

claude mcp add laspalmas-avisos -- npx -y laspalmas-avisos-mcp
claude mcp list   # verificar

Hermes

hermes mcp add laspalmas-avisos --command npx --args -y laspalmas-avisos-mcp
hermes mcp test laspalmas-avisos   # verificar (lista las 8 tools)

OpenClaw

openclaw mcp add laspalmas-avisos \
  --command npx \
  --arg -y \
  --arg laspalmas-avisos-mcp
openclaw mcp doctor laspalmas-avisos --probe   # verificar

Desde código

npm install
npm run build
npx -y -p laspalmas-avisos-mcp laspalmas-avisos-mcp-http   # HTTP en 127.0.0.1:3003/mcp

Herramientas MCP

Tool

Qué hace

get_identity

Identidad guardada (email, teléfono, uuid) o null.

set_identity

Guarda email y teléfono (se preguntan una vez).

list_services

Servicios de LPGC Avisa (id + título).

list_categories

Categorías de un servicio (id + título).

suggest_categories

Sugiere servicio + categoría por palabras.

my_avisos

Avisos del email guardado (o el indicado).

create_aviso

Crea un aviso. Dry-run por defecto; confirm: true para enviar.

create_aviso_from_photo

Aviso desde foto en fases: categoría → preview (GPS EXIF) y envío solo con confirm: true + human_confirmed: true + preview_token. Acepta image_base64, image_path o file_id.

Seguridad de envío

create_aviso es dry-run por defecto: devuelve el payload sin crear nada. Solo con confirm: true hace el POST real — un aviso real que revisa personal municipal. Envía únicamente incidencias reales.

create_aviso_from_photo exige confirmación humana en fases:

  1. Categoría (sin service_id/category_id): sugiere y no envía nada.

  2. Preview (confirm ausente/false): GPS EXIF (o lat/lon manuales), dirección en texto libre, payload + preview_token. No envía nada.

  3. Envío: el agente muestra el preview al humano y espera su "sí"; solo entonces repite la llamada con los MISMOS campos + confirm: true + human_confirmed: true + preview_token. Si cambió cualquier campo, hay que repetir el preview.

Uso como CLI

node dist/cli.js services
node dist/cli.js categories 7
node dist/cli.js identity-set nombre@example.com 612345678
node dist/cli.js my-avisos
node dist/cli.js create 7 33 28.1235 -15.4363 "Calle Triana 1" -- "Papelera llena"          # dry-run
node dist/cli.js create 7 33 28.1235 -15.4363 "Calle Triana 1" -- "Papelera llena" --send   # ENVÍA de verdad
node dist/cli.js from-photo foto.jpg 7 33 "Papelera llena"      # preview desde foto
node dist/cli.js prep-photo foto.jpg [foto-ligera.jpg]   # reduce para el modelo, conserva EXIF/GPS

Servidor HTTP (opcional)

Por stdio cada uno corre su copia. La entrada HTTP sirve para exponer el servidor que corre en TU máquina para que un agente en OTRA máquina lo use.

export LASPALMAS_AVISOS_MCP_SECRET=<un-secreto-largo>            # exige x-mcp-secret o Bearer
export LASPALMAS_AVISOS_ALLOWED_HOSTS=tu-host.tu-tailnet.ts.net  # anti DNS-rebinding
npm run start:http     # 127.0.0.1:3003/mcp

Variables: LASPALMAS_AVISOS_HTTP_PORT (3003), LASPALMAS_AVISOS_HTTP_HOST (127.0.0.1), LASPALMAS_AVISOS_HTTP_PATH (/mcp). Expón solo en red privada (p.ej. tailscale serve, nunca funnel). Para persistencia, launchd/pm2/tmux o similar.

Arquitectura

  • src/client.ts — REST con clave+admin en query; POST JSON a entries.

  • src/identity.ts — email/teléfono/uuid en JSON local (0600).

  • src/avisos.ts — núcleo (servicios, categorías, mis avisos por email, creación con service_id/category_id/address/description/lat/lon/photos).

  • src/photo.ts — foto: EXIF/GPS, subida a tmp, token de preview.

  • src/types.ts — esquemas zod de entrada + payload de creación.

  • src/mcp.ts — buildServer(): registra las 8 tools (compartido por stdio y HTTP).

  • src/server.ts — entrada stdio · src/http.ts — entrada HTTP (/mcp + PUT /upload) · src/cli.ts — CLI.

Notas

  • Ingeniería inversa del APK com.inventiaplus.laspalmas v3.1.0 + verificación en vivo de lecturas y dry-runs (sin crear avisos reales).

Licencia

AGPLv3. Ver LICENSE.

Available Tools

8 tools
create_avisoA

Crea un aviso. IMPORTANTE: por defecto es DRY-RUN (confirm=false) y solo devuelve el payload que se enviaría, SIN crear nada. Para crear de verdad hay que pasar confirm=true. Usa la identidad guardada salvo 'identity'.

Inputs: lat (required), lon (required), address (required), service_id (required), +5 more.

create_aviso_from_photoA

Aviso desde una FOTO en fases. VÍA PREFERIDA: sube la foto con PUT /upload (curl) y pasa file_id; por stdio usa image_path local. Sin service_id/category_id → sugiere (need_category). Con todo → preview + preview_token SIN enviar. Envío: MISMOS campos + confirm:true + human_confirmed:true + preview_token (tras 'sí' humano). Sin las tres NO se envía. La foto viaja en el envío (base64).

Inputs: lat, lon, address, confirm, +10 more.

get_identityA

Devuelve la identidad guardada (email, teléfono, uuid) o null si aún no se preguntó.

Inputs: no named parameters.

list_categoriesC

Categorías de un servicio (id + título).

Inputs: service_id (required).

list_servicesC

Servicios de LPGC Avisa (id + título).

Inputs: no named parameters.

my_avisosC

Avisos del email guardado (o el indicado).

Inputs: skip, take, email.

set_identityB

Guarda email y teléfono del comunicante (se preguntan UNA vez y se reutilizan; el uuid se genera solo).

Inputs: userEmail (required), userPhone.

suggest_categoriesB

Sugiere service_id + category_id por palabras (p.ej. 'contenedor desbordado').

Inputs: hint.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 8 tools

    Disambiguation4/5

    Tools generally target distinct resources and actions: identity get/set, service/category listing, category suggestion, aviso listing, and aviso creation. The main overlap is between create_aviso and create_aviso_from_photo, but the photo-specific workflow is clearly differentiated by description.

    Naming Consistency4/5

    Most tool names follow a predictable snake_case pattern with verb_noun structure (get_identity, set_identity, list_services, create_aviso). The outlier my_avisos uses a possessive/noun phrase rather than a verb, but overall conventions remain readable and mostly consistent.

    Tool Count5/5

    With 8 tools, the set is well-scoped for a municipal incident-reporting assistant. Each tool earns its place by covering identity, lookup, suggestion, listing, and creation workflows without excessive surface area.

    Completeness4/5

    Core lifecycle coverage exists: identity setup, service/category discovery, category suggestion, listing one's avisos, and creating avisos with or without a photo. Minor gaps include no explicit get_aviso detail or status tool and no update/cancel operation, though these may be outside the intended API scope.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      Enables AI agents to report street incidents to Valencia City Council by listing categories, geocoding streets, checking existing reports, and creating nuevos avisos from text or photos with human-confirmed previews. Supports stdio and HTTP transports, with identity and device registration handled locally.
      11
      16 npm
      1
      AGPL 3.0
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI agents to report incidents to the Bilbao City Council (MeJora Bilbao / Bilbo Hobetuz) by listing categories, looking up streets, reviewing existing reports, and creating new ones — including generating a report directly from a geolocated photo. Drafts are dry-run by default and real submissions require explicit human confirmation.
      12
      16 npm
      1
      AGPL 3.0
    • A
      license
      B
      quality
      C
      maintenance
      Enables an AI agent to list the incident categories of Gijón's municipal reporting system and file real service notices on a citizen's behalf, including generating one from a photo by reading its EXIF GPS and suggesting the matching category. Report creation is dry-run by default and only sends after explicit human confirmation, using a saved email as the contact identity and no credentials.
      7
      18 npm
      AGPL 3.0