# SpotHero Parking MCP for AI Agents AI Agent Connect > SpotHero Parking lets you search, compare, and book parking spots across 400+ cities using your AI agent. It connects directly to the SpotHero API, allowing you to handle everything from checking real-time prices to managing vehicle details and canceling reservations through a simple conversation. It's the fastest way to get your agent handling urban mobility tasks without manual web browsing. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_0jdigNzKsL4jNpCKgPcqfSapH1fdqNoLnJsr8V5a/ai-agent-connect - **Tags:** parking-reservations, urban-mobility, dynamic-pricing, location-services, booking-api ## Description Dealing with urban parking is usually a mess of opening multiple tabs, checking different garage rates, and hoping the spot you want is actually open. This Connector changes that by letting your AI agent do the heavy lifting. Instead of hunting for a space, you just tell your agent where you're headed and when you need to be there. It pulls real-time data to find the best spots, shows you what the actual costs look like for your specific timeframe, and handles the booking in one go. You can even see what's happening nearby, like concerts or games, to figure out if parking is going to be tight. If you need to swap cars or change a time, you just tell the agent to update the reservation. It's about moving from searching to done. You can find this integrated with the rest of your workflow in the Vinkius catalog to keep your mobility tasks organized. It handles the boring stuff like entering license plates and payment IDs so you can just focus on getting where you need to go. ## Tools ### book_parking Create a reservation by providing a spot ID, times, payment info, and vehicle details. This helps you secure a spot quickly. ### cancel_reservation End an active booking and check if you are eligible for a refund. This is useful for changing plans on the fly. ### list_reservations See all your current, past, and upcoming parking bookings in one list. This keeps your itinerary organized. ### get_pricing Pull dynamic rates for a specific spot to compare costs before you commit. This helps you find the best deal. ### update_vehicle_info Change the car details for an existing reservation if your plans shift. This keeps your booking valid even if you swap cars. ### search_events Look for local events that might make parking harder to find or more expensive. This helps you plan for high-demand periods. ### get_garage_details Get the specifics on a garage, including its amenities and operating hours. This ensures the spot meets your needs. ### get_spot_details Fetch deep details and current pricing for one specific parking location. This provides a clear picture before booking. ### get_reservation Pull up the full details for a specific booking you have already made. This is great for quickly checking your confirmation. ### search_parking Find available spots near a location for a specific time window. This is the first step in finding a place to park. ## Prompt Examples **Prompt:** ``` Find parking near the stadium for a game starting at 7 PM tonight. ``` **Response:** ``` I found a few spots near the stadium for your 7 PM start time: | Garage | Price | Distance | | :--- | :--- | :--- | | **Icon Parking** | $25 | 0.3 miles | | **Edison ParkFast** | $35 | 0.1 miles | | **City Center Garage** | $40 | 0.5 miles | *Note: Prices are currently higher due to the nearby event.* ``` **Prompt:** ``` I need to book spot 9988 for my truck from 10 AM to 2 PM tomorrow. Use my saved payment method. ``` **Response:** ``` ### Reservation Confirmed! **Reservation ID:** SH-772104 **Time:** 10:00 AM - 2:00 PM (Tomorrow) **Vehicle:** Ford F-150 (ABC-1234) **Total Cost:** $42.00 A confirmation email with your QR code has been sent to your primary address. ``` **Prompt:** ``` Are there any big events downtown this weekend that might make parking expensive? ``` **Response:** ``` Yes, there are three major events downtown this weekend: * **Music Festival** (Saturday, 12 PM - 10 PM) * **City Marathon** (Sunday, 8 AM - 4 PM) * **Night Market** (Friday, 6 PM - 12 AM) Parking rates in the downtown core are expected to increase by approximately 20-30% during these times. ``` ## Capabilities ### Find available parking spots Your agent identifies open spots based on your specific location and timeframe. ### Compare real-time pricing See dynamic rates for different durations before you commit to a booking. ### Create parking reservations Secure a spot instantly by providing vehicle details and payment info. ### Update vehicle information Change the car details on an existing reservation without losing your spot. ### Cancel active bookings End a reservation and check for refund eligibility in one step. ### Monitor local events Discover nearby events that might affect parking availability or costs. ### Access garage amenities Get specific details on garage features, hours, and contact info. ## Use Cases ### Fleet logistics for delivery teams A fleet manager asks their agent to find the 5 cheapest spots near a warehouse for a delivery team arriving at 8 AM. The agent uses search_parking and get_pricing to find the best options. ### Coordinating concert parking An event coordinator wants to know the parking situation for a show. They ask the agent to check for nearby events and find a spot with a 5-minute walk using search_parking and search_events. ### Swapping vehicles for a business trip A traveler realizes they are taking a different car than planned. They tell the agent to update the license plate on their reservation for tomorrow using update_vehicle_info. ### Building a travel navigation tool A developer builds a custom travel app and uses the Connector to pull real-time garage amenities like EV charging and height limits to show users before they arrive. ## Benefits - Stop manual searching: Use search_parking to find spots instantly without opening a browser or toggling between apps. - Accurate cost planning: Use get_pricing to see real-time rates for your exact stay duration to avoid unexpected fees. - Faster bookings: Use book_parking to secure a spot with one command instead of manually filling out long web forms. - Easier fleet management: Use list_reservations to keep track of all company vehicles and their parking spots in one place. - Better planning: Use search_events to anticipate high-demand periods before you head out and find better options. - Flexible changes: Use update_vehicle_info to swap cars on the fly without losing your reservation or having to rebook. ## How It Works The bottom line is that it turns your AI into a personal valet that handles the logistics of urban parking automatically. 1. Subscribe to the SpotHero Parking MCP and get your Partner API Key. 2. Enter your SpotHero Base URL and API Key into your AI client. 3. Ask your agent to find or book a spot in any of the 400+ supported cities. ## Frequently Asked Questions **Can SpotHero Parking find spots in my city?** Yes, this Connector connects to the SpotHero network, which covers over 400 cities across North America. **Can I use this to manage a fleet of vehicles?** Absolutely. You can use it to list all your current reservations, update vehicle details for different cars, and book spots for multiple drivers. **Does it show real-time prices?** Yes, it pulls dynamic pricing for specific spots based on the exact dates and times you need, so you see the actual cost before booking. **Can I cancel a booking if I change my mind?** Yes, your agent can cancel active reservations and check the specific refund policy for that booking to see if you're eligible for a return. **How do I find out if a garage has EV charging?** You can ask your agent to get the details for a specific garage, which includes information on amenities like EV charging and height limits. **Can my AI agent book the parking for me?** Yes, your agent can handle the entire flow from searching for a spot to creating the final reservation with your vehicle and payment info. **How do I book a parking spot via the API?** Use the book_parking action. You need the spot_id, start/end times, a valid payment method ID, and vehicle details (plate, make, model) in JSON format. **Can I compare prices for different spots?** Yes! Use search_parking to get a list of spots with their total costs, or use get_pricing to check the specific rate for a single spot over a duration. **How do I cancel a reservation?** Use the cancel_reservation action with the reservation_id. Check SpotHero's policy for refund timelines.