# Public Works Service Request Planner AI Agent Connect

> Public Works Service Request Planner MCP converts raw notes about neighborhood issues like potholes or broken streetlights into formal, professional documentation. It helps you bridge the gap between seeing a problem and getting a city department to actually fix it by organizing evidence and planning follow-ups.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_fpQwPYD5hlPFgc3dc4OfbZpkVUEShbqmbPD1Wf3R/ai-agent-connect
- **Tags:** municipal, infrastructure, reporting, public-works, citizen-engagement

## Description

You see a broken swing set at a park or a deep pothole on a busy corner. Instead of sending a vague, frustrated message to your local government, you can use this MCP to build a professional case. Your AI client takes your rough notes and location data to produce a structured report that municipal officials can actually use. It handles the heavy lifting of organizing your evidence, linking photos to specific descriptions, and even telling you exactly when to follow up if the city ignores your initial request. It's built to move community reporting from simple complaints to organized, actionable service requests that demand attention.

## Tools

### create_submission_plan
This tool provides the exact instructions and confirmation text you need to file your request correctly.

### generate_escalation_schedule
This tool builds a timeline so you know exactly when to contact the department again if they don't respond.

### generate_request_narrative
This tool turns your raw observations and location details into a professional, concise summary for city officials.

### map_evidence_references
This tool connects your photo identifiers to the specific parts of the issue you described.

## Prompt Examples

**Prompt:** 
```
I found a large pothole at the intersection of Main St and 5th Ave. It's quite deep and causing cars to swerve. The category is Roadways.
```

**Response:** 
```
Location: Intersection of Main St and 5th Ave. Issue: A deep pothole is present in the roadway, causing vehicles to swerve to avoid damage. Category: Roadways. Priority: Urgent.
```

**Prompt:** 
```
The streetlight at 123 Oak Lane is flickering constantly. Category is Lighting.
```

**Response:** 
```
Location: 123 Oak Lane. Issue: The street lighting is malfunctioning due to constant flickering. Category: Lighting. Priority: Routine.
```

**Prompt:** 
```
There is a broken swing set in Central Park. Category is Parks and Recreation.
```

**Response:** 
```
Location: Central Park. Issue: A swing set in the playground area is broken and requires repair. Category: Parks and Recreation. Priority: Routine.
```

## Capabilities

### Narrative Generation
Your agent writes professional summaries from your rough notes.

### Evidence Mapping
The AI links your photos to specific parts of the reported issue.

### Submission Planning
Your agent generates the specific text and steps needed to file the report.

### Follow-up Scheduling
The AI creates a timeline for when to escalate the issue if it remains unresolved.

## Use Cases

### Roadway Repair
Report deep potholes or damaged pavement with professional descriptions that highlight safety risks.

### Public Lighting
Document flickering or broken streetlights to ensure municipal maintenance crews have clear details.

### Park Maintenance
Report broken playground equipment or damaged park facilities using structured narratives.

### Issue Tracking
Use the escalation schedule to ensure city departments don't ignore your reports over time.

## Benefits

- Converts informal notes into professional municipal language.
- Organizes photo evidence to support specific claims.
- Provides a clear timeline for following up on unresolved issues.
- Reduces the friction between spotting a problem and filing a report.

## How It Works

Get your report ready in minutes by connecting your AI client to Vinkius.

1. Connect your preferred AI client to the MCP via Vinkius.
2. Describe the infrastructure issue and location to your agent.
3. Provide photo identifiers to link visual evidence to the description.
4. Receive a professional narrative and a step-by-step submission plan.

## Frequently Asked Questions

**How do I use this MCP with my AI client?**
You connect once through Vinkius, and then the tools are immediately available in any MCP-compatible client like Claude, Cursor, or Windsurf.

**What kind of issues can I report?**
You can report any municipal infrastructure issues, such as roadway damage, lighting malfunctions, or park equipment failures.

**Does this MCP host my data?**
Vinkius hosts and manages the MCP so it is ready to run whenever you need it.

**Can I use photos with my reports?**
Yes, the tool includes a feature to map your photo identifiers to specific parts of your written description.

**What if the city doesn't respond to my request?**
The MCP can generate an escalation schedule that tells you exactly when to follow up with the department.