# Parkopedia MCP

> Parkopedia gives your AI client global access to parking logistics data. You can search for spots, find EV chargers, read real-time occupancy, check pricing, and view local restrictions across 75+ countries. It’s everything you need to map urban movement.

## Overview
- **Category:** iot-hardware
- **Price:** Free
- **Tags:** parking-data, ev-charging, real-time-availability, geospatial-api, location-services, smart-city

## Description

You're hooking your AI client up to Parkopedia—it gives you global access to parking logistics data. You can map out urban movement across 75+ countries with this server. It handles everything from finding street spots to figuring out EV charging details and reading real-time availability.

**Finding Location Data**
You need to know where the spots are, right? Use `search_parking` for a general search near an address, letting you filter by spot type or if it's currently available. If you have coordinates, you can use `search_by_bounds` to find every parking spot within a specific rectangular area. You can also locate charging stations specifically with `search_ev_charging`, which lists all EV chargers near given coordinates or an address. Need something else nearby—like a restroom or covered entrance? Run `search_amenities` to pull up those nearby facilities using location data.

**Checking Status and Rules**
Once you find the area, you gotta know if it's usable. Use `get_occupancy` to get the current count of available spots in a garage or lot—it’s real-time availability. Don't assume parking is free; run `get_pricing` to check out the cost structure for a spot, giving you hourly rates and daily maximums. You can always confirm local legal limits by calling `get_parking_restrictions`, which returns all time limits, permit needs, and local rules for that exact area.

**Getting Deep Details**
You want specifics on what you found? If you have the ID of a spot, `get_spot_details` pulls up comprehensive info about it, including its size and specific features. For electric vehicles, use `get_ev_charger_details` to get deep specs for a single charging station—you'll know the connector types and who the operator is. You can also run `search_amenities` if you need more facility details.

**Analyzing Trends and Patterns**
For long-term planning, skip guesswork and use hard data. Run `get_analytics` to fetch historical trends about parking patterns for a location. This gives you the big picture of usage over time. You can combine this with spot searches to tell clients exactly what they're getting into.

**How Your Agent Uses These Tools**
Your agent performs these lookups by calling specific tools and passing parameters like addresses, coordinates, or bounding boxes. For example, it runs `search_parking` using a location, then takes the resulting spot IDs and feeds them into `get_occupancy` to get immediate availability counts. If you find an EV charger via `search_ev_charging`, your agent can immediately pass that ID to `get_ev_charger_details` to validate the connector type before recommending it to a user.

It's all structured data going into your workflow, giving you everything you need to map out any urban movement. You don’t have to deal with messy spreadsheets or calling up city hall; this server gives you clean access to global parking logistics.

## Tools

### search_amenities
Finds nearby facilities related to parking, such as restrooms or covered access points.

### get_analytics
Fetches historical data and trends about parking patterns for a specific location.

### search_by_bounds
Searches for all available parking spots within a defined geographic rectangular area (bounding box).

### get_spot_details
Gets comprehensive information about any individual parking spot, including size and features.

### get_ev_charger_details
Retrieves detailed specifications, including connector types and operator info, for a single EV charging station.

### search_ev_charging
Finds and lists all EV charging stations located near a specific address or coordinates.

### get_occupancy
Reports the current real-time availability count for a specific parking spot or garage.

### get_pricing
Looks up the cost structure—hourly rates, daily maximums—for a designated parking spot.

### get_parking_restrictions
Checks and returns all local legal rules, time limits, and permit requirements for a given area.

### search_parking
Performs a general search to find parking spots near an address, considering multiple variables like type and availability.

## Prompt Examples

**Prompt:** 
```
Find EV chargers near Central Park.
```

**Response:** 
```
Found 5 EV chargers within 1km. 1. Tesla Supercharger (500m) — 8 stalls. 2. ChargePoint (800m) — CCS/CHAdeMO. 3. Blink Charging (1.2km) — Level 2.
```

**Prompt:** 
```
Are there parking restrictions on 5th Ave right now?
```

**Response:** 
```
Current restrictions: No parking 4 PM - 7 PM (Rush Hour). Metered parking valid until 6 PM. Residential permit required after 8 PM.
```

**Prompt:** 
```
What is the occupancy at the Times Square garage?
```

**Response:** 
```
Times Square Garage: 42 spaces available out of 500 (8% full). Current rate: $25/hr.
```

## Capabilities

### Find Location Data
Search for parking spots (`search_parking`), find EV charging stations (`search_ev_charging`), or look for nearby amenities (`search_amenities`) using location coordinates.

### Check Status and Rules
Get real-time occupancy rates for a spot (`get_occupancy`), check specific pricing structures (`get_pricing`), or view current legal parking restrictions (`get_parking_restrictions`).

### Get Deep Details
Retrieve detailed information about any spot (`get_spot_details`) or get specifics on an EV charger model (`get_ev_charger_details`).

### Analyze Trends
Pull historical data and trends for a given area using `get_analytics` to inform long-term planning.

## Use Cases

### The Last-Minute Commute
A user asks their agent: 'Where can I park near the theater that accepts my car?' The agent runs `search_parking` using coordinates, then calls `get_occupancy` on the top three results. It reports back: 'The garage at 123 Main St has 45 spots available and costs $20/day.' Problem solved.

### Electric Vehicle Trip Planning
An EV owner needs to plan a cross-town trip. The agent uses `search_ev_charging` around the destination, checks required plug types, and then calls `get_ev_charger_details` to confirm if the charging rate meets their expected speed.

### Optimizing Delivery Routes
A fleet manager needs a route for 10 deliveries. The agent uses `search_by_bounds` to map out all potential stops, then calls `get_pricing` and `get_parking_restrictions` for every single stop to factor cost and legality into the final manifest.

### Urban Development Analysis
A city planner asks: 'What is the parking pressure in this district?' The agent uses `search_by_bounds` to define the area, then runs `get_analytics` to see historical trends and identifies zones needing more charging infrastructure.

## Benefits

- Avoid dead ends. Use `get_occupancy` to check if a lot has available spaces *before* the user drives there, saving time and frustration.
- Know the rules instantly. Running `get_parking_restrictions` prevents users from accidentally parking in a no-metered or permit-only zone.
- Calculate trips accurately. Combine `search_parking`, `get_pricing`, and `get_spot_details` to give the user a total estimated cost for their journey.
- Handle EV logistics cleanly. Use `search_ev_charging` to filter by connector type (e.g., CCS) and get detailed specs with `get_ev_charger_details` in one flow.
- Build smart city models. Pass location data into `get_analytics` to provide historical context, moving beyond simple point-in-time availability.

## How It Works

The bottom line is that your agent treats the entire Parkopedia API as one coherent set of tools, eliminating the need for multiple, separate calls to different map services.

1. First, your agent calls the appropriate search tool (e.g., `search_parking`) and passes the target coordinates or bounding box.
2. The server processes the request against its global data sources to filter results based on criteria like EV charging, amenities, or time constraints.
3. It returns a structured JSON object containing all relevant details: availability counts, current pricing, restrictions, or charger types.

## Frequently Asked Questions

**How do I find chargers near me using search_ev_charging?**
You pass the coordinates or address to `search_ev_charging`. The tool returns a list of nearby stations. You then use `get_ev_charger_details` on any specific result ID to confirm plug types (CCS, CHAdeMO) and operator info.

**Can I check the current cost using get_pricing?**
Yes, you run `get_pricing` for a specific spot. This tool returns structured rate data, including hourly fees and maximum daily charges. It doesn't tell you if it's *currently* open, though.

**What is the difference between search_parking and search_by_bounds?**
`search_parking` handles general queries near an address, taking into account user intent. `search_by_bounds` requires you to provide a precise geographic bounding box, making it ideal for analyzing entire quadrants of a map.

**How do I know if a spot is full using get_occupancy?**
You call `get_occupancy` and pass the specific spot ID. The response gives you the live count: total available spaces out of the garage's capacity.

**When I use `get_parking_restrictions`, how reliable is the data for local laws?**
The restrictions reflect compiled legal limits. However, the API isn't always aware of temporary signs or immediate construction closures. Always verify critical rules with physical signage.

**What kind of usage patterns can I pull using `get_analytics`?**
You access historical data and trends for a location. This lets you calculate average occupancy rates or determine peak demand times, which is useful for planning logistics.

**How do I confirm the specific connector types when running `get_ev_charger_details`?**
The tool provides explicit details on supported standards. It lists all compatible connectors—like CCS or CHAdeMO—so you know exactly which plugs will work at that station.

**If I search for features using `search_amenities`, does it cover covered parking and restrooms?**
Yes, this tool finds general convenience infrastructure near a spot. It covers things like available restrooms, covered areas, or valet services, not just the parking stall itself.

**Does Parkopedia cover EV charging stations?**
Yes! The search_ev_charging tool finds EV chargers globally. Use get_ev_charger_details to see connector types (CCS, CHAdeMO, Tesla, etc.) and power output.

**Can I check parking restrictions before parking?**
Yes! Use get_parking_restrictions with coordinates to see legal limits, time bans, and resident-only rules. Essential for avoiding tickets.

**Is real-time occupancy data available?**
Where supported by the operator, get_occupancy returns the number of available vs total spaces in real-time. Availability varies by location.