chiclana-avisos-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GECOR_TOKEN | Yes | Token de sesión GECOR. Obligatorio para list_my_avisos y para enviar avisos; también identifica al peticionario. | |
| GECOR_API_URL | No | URL base de la API de GECOR. | https://gecorapiwe.azurewebsites.net/api |
| GECOR_AYTO_ID | No | Municipio activo inicial (Chiclana de la Frontera). | 268 |
| GECOR_LANGUAGE | No | Idioma de las consultas a GECOR (p. ej. listado de municipios). | es |
| GECOR_PHOTO_DIRS | No | Directorios permitidos para image_path, separados por ':' (';' en Windows). Solo rutas absolutas; sustituyen a los valores por defecto. | tmp, ~/Downloads, ~/Pictures, ~/Desktop, ~/.hermes |
| GECOR_TIMEOUT_MS | No | Tiempo máximo por petición, en ms. Valores no válidos usan el defecto; el máximo es 120000. | 20000 |
| GECOR_MAX_PHOTO_BYTES | No | Tamaño máximo de la foto recibida. | 20971520 |
| GECOR_PROCEDENCIA_WEB | No | Procedencia del aviso cuando la ficha del ayuntamiento en GECOR no incluye ProcedenciaWeb. Valores que no sean enteros positivos usan el defecto. | 1390 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| whoamiA | Muestra el municipio activo y si GECOR_TOKEN está configurado. |
| list_ayuntamientosB | Lista todos los municipios soportados por la plataforma GECOR (con sus identificadores y nombres). |
| set_ayuntamientoA | Cambia el ayuntamiento activo para las consultas e incidencias. |
| list_categoriesA | Obtiene el catálogo de tipologías de incidencias (familias, elementos/subcategorías y tipos de incidencia) para el ayuntamiento activo. |
| resolve_locationB | Valida y resuelve una ubicación en el municipio activo mediante coordenadas GPS o búsqueda de calles en el callejero oficial de GECOR. |
| create_aviso_from_photoA | Única herramienta para avisos, en dos fases. Para previsualizar, llama con los campos del aviso y una foto obligatoria (image_path o image_base64), sin preview_token ni campos de confirmación. La previsualización devuelve además una miniatura de la foto (imagen JPEG ≤1024 px sin EXIF, o el PNG pequeño tal cual) para que redactes la descripción y compruebes la categoría con lo visible; si omites description, devuelve phase: need_description con la miniatura y sin preview_token. Enseña el resumen exacto y espera un sí explícito. Solo entonces vuelve a llamar con únicamente preview_token, confirm:true y human_confirmed:true. Si el usuario pide cambios, crea una nueva previsualización; nunca envíes por inferencia. La previsualización no envía nada; confirmar envía un aviso real al ayuntamiento y la foto se sube únicamente durante ese envío confirmado. |
| list_my_avisosB | Consulta los avisos previamente registrados por el usuario para consultar su estado de tramitación. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool targets a distinct action: identity check, listing municipalities, setting active municipality, catálogos, location resolution, aviso creation, and listing own avisos. The overlapping but functional pair of list_ayuntamientos/set_ayuntamiento is clearly differentiated by verb. create_aviso_from_photo is a single tool handling both preview and confirm, reducing ambiguity.
Mostly consistent snake_case verb_noun (list_ayuntamientos, set_ayuntamiento, list_categories, resolve_location, list_my_avisos). whoami and create_aviso_from_photo deviate slightly but remain readable and domain-appropriate.
Seven tools is well-scoped for a municipal incident-reporting MCP. Each tool serves a clear role in the workflow without redundancy.
Covers the core lifecycle: authentication, municipality selection, category lookup, location resolution, incident creation, and status listing. Missing update/delete or detail view for avisos, but an agent can work around via create+list for the stated purpose.