# Ayuntamiento de Zaragoza MCP for AI Agents AI Agent Connect

> Ayuntamiento de Zaragoza MCP gives your agent direct access to Zaragoza's city services, public datasets, and municipal booking systems. It lets you submit service requests, query urban data like monuments or restaurants, and manage city appointments without leaving your chat interface. Whether you're a resident reporting a broken sidewalk or a researcher pulling city stats, this tool handles the municipal heavy lifting for you.

## Overview
- **Category:** data-management
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_awKiSlNO3EIlYIgZj5tUvcZeB5cDrfJ4rYHh4rxS/ai-agent-connect
- **Tags:** open-data, open311, citizen-services, city-infrastructure, public-records, service-requests

## Description

This Connector connects your AI client directly to the Zaragoza City Council's open data and public service infrastructure. Instead of hunting through clunky government websites or navigating complex forms, you can just ask your agent to handle the heavy lifting. It handles everything from reporting a broken street light to finding specific historical monuments in the city. If you need to book a municipal appointment, the agent checks the schedule and gets it done for you. It even lets you dive into the city's linked data for deeper analysis. You'll find it's a lot easier to manage city-related tasks when you can just talk through them. Vinkius makes it simple to get this connected so you can start interacting with Zaragoza's public records and services immediately. You can manage your own requests, check status updates, or explore collaborative maps without ever opening a new tab. It turns a slow, manual process into a few quick questions. Whether you're a local resident looking to fix a sidewalk issue or a developer pulling urban stats, this tool removes the friction of interacting with city systems. You get a direct line to official data and services, allowing you to stay in your flow while the agent manages the details of the municipal backend.

## Tools

### book_appointment
Schedules a Cita Previa appointment for you. This helps you get municipal services without navigating complex web forms.

### create_map
Builds a new collaborative map for urban data. You can use this to organize spatial information with other city users.

### list_open311_requests
Lists all your submitted service requests and their statuses. This gives you a clear history of all your interactions with city maintenance.

### list_open311_services
Shows the full list of Quejas y Sugerencias services. This lets you know every way you can give feedback to the city council.

### list_public_maps
Lists all public collaborative maps available in the city. Use this to explore what other people have mapped in Zaragoza.

### list_user_maps
Shows the collaborative maps you have created or joined. This helps you manage your personal contributions to city data.

### query_dataset
Searches for specific items like restaurants or monuments in city datasets. This is the primary way to find local points of interest.

### submit_open311_request
Sends a new complaint or suggestion to the city council. This allows you to report issues like broken lights or trash piles instantly.

### delete_map
Removes an existing collaborative map from the system. This is useful for cleaning up old or outdated urban data layers.

### execute_sparql_query
Runs advanced SPARQL queries against the city's semantic web endpoint. This allows for deep data analysis of linked urban records.

### get_agenda_availability
Checks which dates and times are open for a specific city service. Use this to find a convenient time for your next appointment.

### get_agenda_detail
Pulls specific details for a scheduled appointment. This helps you see the exact time and location of your Cita Previa.

### get_map_detail
Retrieves specific information about a collaborative map. This provides extra context for the data shown on city maps.

### get_my_appointments
Shows a list of all your currently booked appointments. Use this to keep track of your upcoming municipal visits.

### get_open311_request
Pulls the status and details of a specific service request. This lets you see if the city has addressed your reported issue.

### get_open311_service
Describes the types of services available for reporting via Open311. This helps you understand what kind of problems you can report.

### list_agendas
Shows all available appointment types for city services. Use this to see all the different Cita Previa options.

## Prompt Examples

**Prompt:** 
```
Find a park near Plaza del Pilar.
```

**Response:** 
```
I've searched the Zaragoza urban datasets for parks near Plaza del Pilar. Here is what I found:

| Park Name | Distance | Notes |
| :--- | :--- | :--- |
| Parque de la Abadía | 0.5 km | Historic garden |
| Jardines de la Plaza | 0.8 km | Public seating |

Would you like the exact coordinates for any of these?
```

**Prompt:** 
```
Report a trash pile on Calle Mayor.
```

**Response:** 
```
I've submitted a new service request for 'Waste and Cleaning' at Calle Mayor. 

**Request Details:**
- **Issue:** Trash pile accumulation
- **Location:** Calle Mayor
- **Status:** Submitted
- **Reference ID:** 882910

I can check the status of this request for you later using the tracking tool.
```

**Prompt:** 
```
Is there an appointment for a new license tomorrow?
```

**Response:** 
```
Checking the availability for the 'Licensing' agenda for tomorrow...

**Available Slots:**
- 09:00 AM
- 10:30 AM
- 02:15 PM
- 04:00 PM

Would you like me to book one of these for you?
```

## Capabilities

### Submit city service requests
Your agent can report infrastructure issues or suggestions directly to the city council via the Open311 system.

### Book municipal appointments
Check availability and secure a spot for city services without navigating through complex web forms.

### Query urban datasets
Search for specific items like local restaurants, historical monuments, and other city equipment.

### Manage collaborative maps
Create, list, and inspect public or user-specific maps to visualize urban data and city features.

### Run deep data analysis
Execute SPARQL queries against the city's linked data infrastructure for advanced research and analysis.

## Use Cases

### Reporting a broken pipe
A resident tells the agent about a leak, and it uses `submit_open311_request` to notify the city council immediately.

### Booking a city permit
A business owner asks for an appointment, and the agent uses `get_agenda_availability` to find a convenient slot.

### Researching city history
A student uses `query_dataset` to find all monuments in a specific neighborhood for a school project.

### Creating a food map
A blogger asks the agent to list public maps and then use `create_map` to start a new collaborative guide.

## Benefits

- Skip the website: Use `book_appointment` to secure a spot without navigating confusing city portals.
- Faster reporting: Submit issues like broken lights using `submit_open311_request` instantly.
- Deep data access: Run `execute_sparql_query` to pull complex linked data for research.
- Map management: Create and list urban maps using `create_map` and `list_public_maps`.
- Real-time tracking: Check your status with `list_open311_requests` instead of calling the office.

## How It Works

The bottom line is you get to handle city bureaucracy through a simple chat instead of a maze of web forms.

1. Subscribe to this Connector in the Vinkius catalog.
2. Add your Zaragoza API Key and Client ID to your configuration.
3. Ask your agent to find a restaurant or book an appointment.

## Frequently Asked Questions

**Can the Ayuntamiento de Zaragoza MCP help me book a city appointment?**
Yes, it allows your agent to check real-time availability and book 'Cita Previa' slots for you directly. You can ask for specific dates or check which services have open slots.

**How do I report a broken street light using the Ayuntamiento de Zaragoza MCP?**
Your agent can use the Open311 tool to submit a formal request for repairs. You just need to tell your agent where the light is located and what the issue is.

**Can I use the Ayuntamiento de Zaragoza MCP to find local restaurants?**
Yes, it can query the official city dataset to find dining options and other points of interest. It's a great way to get real-time city data for planning your day.

**Is the Ayuntamiento de Zaragoza MCP good for urban researchers?**
It's excellent for researchers because it supports SPARQL queries. This gives you access to the city's linked data infrastructure for deep, structured analysis.

**Does the Ayuntamiento de Zaragoza MCP let me see my previous reports?**
Yes, you can ask your agent to list all your submitted service requests. It will show you the status of every report you've made to the city council.

**Can I use this Connector to see public maps of the city?**
Yes, your agent can list all public collaborative maps. This lets you explore urban data and spatial information shared by the community and the city.

**How can I find specific monuments or restaurants in Zaragoza?**
Use the `query_dataset` tool. You can specify the dataset (e.g., 'monumento' or 'restaurante') and apply filters like 'q' for names or 'point' and 'distance' for proximity searches.

**Can I report a broken street light or a pothole using this server?**
Yes! Use the `submit_open311_request` tool. You'll need to provide the `service_code` (which you can find via `list_open311_services`) and a description of the issue.

**How do I check if there are available slots for a city hall appointment?**
First, list available agendas with `list_agendas`, then use `get_agenda_availability` with the specific agenda ID to see open time slots.