# NYC Events & Permits AI Agent Connect > NYC Events & Permits provides direct access to city-permitted event data and Parks recreation programs. Your AI client can pull upcoming event schedules, check for street closures, look up historical event records since 2007, and find summer sports sessions like Kids in Motion. It works without needing an API key, making it easy to plan trips or routes around local closures. ## Overview - **Category:** events - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_ZKvMPLoZN3F4RYRCm3lXWx5Ye6uhwqzGXxLapTjX/ai-agent-connect - **Tags:** new-york, nyc, events, permitted-events, street-closures, summer-sports, kids-in-motion, things-to-do ## Description You can use this MCP to navigate New York City's complex schedule of permitted activities. Instead of digging through city databases, you ask your agent for specific details like upcoming farmers markets in Manhattan or street closures happening this weekend. The data includes roughly 31,000 upcoming events and a massive historical archive of 2.9 million records dating back to 2007. You can filter by borough, event type, or agency to find exactly what you need. If you are planning a route, the street closure flags tell you which events will block traffic or sidewalks. For families, the tool provides access to Parks summer sports and Kids in Motion sessions, including attendance and location data. It's built for anyone needing to know what's happening on the ground in the five boroughs. ## Tools ### count_events This tool provides a quick count of upcoming NYC permitted events within a specific timeframe. Use it to see how many results to expect before you pull a full list. ### list_events This tool returns a list of upcoming NYC permitted events including names, dates, locations, and street closure types. You can filter by borough or event type, and use the closures_only flag to find only those events blocking streets or sidewalks. ### list_summer_sports This tool retrieves details for Parks Summer Sports & Entertainment and Kids in Motion sessions. It provides the borough, park name, date, and reported attendance for these seasonal programs. ### search_historical_events This tool searches through nearly 2.9 million permitted events recorded since 2007. It uses the same filtering logic as the upcoming event tool to find past parades, festivals, or street events. ### top_event_types This tool ranks upcoming event types by their frequency. It helps you identify which types of events are most common in your chosen window. ### top_historical_event_types This tool ranks historical event types by count. You can use it to compare the current event landscape against what happened in the past. ### top_summer_sports This tool identifies the most frequent sports reported in summer sessions. It lists the most common activities like basketball, soccer, or pickleball. ### top_summer_sports_parks This tool ranks parks and playgrounds by the number of summer sports sessions they hosted. Use it to find the most active recreation areas in the city. ## Prompt Examples **Prompt:** ``` What farmers markets are on in Manhattan this weekend? ``` **Response:** ``` The list_events tool with event_type set to 'Farmers Market' and event_borough set to 'Manhattan' shows several upcoming sessions, including one at Union Square this Saturday. ``` **Prompt:** ``` Which events are closing streets in NYC this week? ``` **Response:** ``` Using list_events with the closures_only flag set to true shows three events this week with Full Street Closures and one with a Partial Sidewalk Closure. ``` **Prompt:** ``` Which parks hosted the most summer sports sessions this season? ``` **Response:** ``` The top_summer_sports_parks tool shows that Central Park and Prospect Park have hosted the highest number of sessions this season. ``` ## Capabilities ### Street Closure Detection Your agent identifies events that will block roads or sidewalks to help you plan routes. ### Historical Data Lookups The tool accesses millions of past event records to answer questions about city activity trends. ### Recreation Tracking Your AI client can find specific summer sports and Kids in Motion program sessions in local parks. ### Event Type Discovery The tool ranks event types so you can find specific categories like block parties or parades. ### Borough-Specific Filtering You can narrow down all event and sports data to a specific NYC borough. ## Use Cases ### Route Planning Check for street closures in a specific borough to avoid blocked roads during a commute. ### Weekend Planning Find local farmers markets or block parties happening in your neighborhood this weekend. ### Family Activities Locate upcoming Kids in Motion or summer sports sessions at nearby playgrounds. ### Trend Analysis Compare current event types against historical data to see how city activity has changed. ## Benefits - Access city-permitted event data without needing an API key. - Identify street closures to avoid traffic delays. - Find specific community recreation programs in local parks. - Query millions of historical event records instantly. ## How It Works Connecting to this MCP gives your AI client immediate access to NYC Open Data. 1. Connect your preferred MCP-compatible client to Vinkius. 2. Select the NYC Events & Permits MCP from the catalog. 3. Ask your AI client a question about NYC events or street closures. 4. The agent calls the appropriate tool to fetch real-time or historical data. 5. You receive specific, actionable information about city activities. ## Frequently Asked Questions **Do I need an API key to use this MCP?** No, this MCP is keyless and works immediately once connected through Vinkius. **Can I find out if a street will be closed for an event?** Yes, you can use the list_events tool with the closures_only flag to find events that cause full street, partial sidewalk, or curb lane closures. **How far into the future can I see upcoming events?** The tool can look ahead up to 365 days, though some planned dates extend into 2027. **What kind of summer programs are included?** The data includes Parks Summer Sports & Entertainment (S.S.E) and Kids in Motion (K.I.M.) sessions. **How much historical data is available?** The tool provides access to approximately 2.9 million permitted events dating back to 2007. **Do I need an API key?** No. NYC Open Data serves all public datasets anonymously over its SODA API (data.cityofnewyork.us). This MCP defines no credentials and needs nothing configured. **Do the text filters ignore case or match partial values?** No. The NYC data platform only supports exact-match filters, so a filter value must equal the stored value. In this MCP, event types are stored as "Sport - Youth", "Special Event", "Farmers Market", "Block Party", "Street Event", "Parade" and similar; boroughs as full names ("Manhattan", "Staten Island"); the permitting agencies as "Parks Department", "Street Activity Permit Office", "Police Department" and "Mayors Office of Media & Entertainment" (the entertainment agency is stored with a straight apostrophe); street closures as "N/A", "Full Street Closure", "Partial Sidewalk Closure" or "Curb Lane Only". Use top_event_types, or a list tool with no filters, to see the exact stored values before filtering. **Why do the upcoming-event tools use a forward window?** The current permitted-events table holds about 31,000 rows and carries future planned dates (into 2027), so list_events and the type rankings scan a forward window from today (default 90 days, max 365). The historical table holds about 2.9 million rows, so its tools scan a lookback window instead (default 90 days, max 365, capped at today). Both windows keep every query under a second. **Why does list_summer_sports return few or no rows in autumn?** The Parks summer sports and Kids in Motion programs run seasonally, roughly April to mid-July. The 2026 season data ends at 2026-07-17, so a lookback window starting in autumn holds few or no sessions. Use days: "365" to reach back into the last full season. Most sessions also leave the sport unspecified, so the top_sports ranking starts with an "Unspecified" row.