# Foursquare MCP for AI Agents AI Agent Connect > Foursquare MCP gives your AI agent the ability to search millions of locations, pull venue details, and grab user reviews. Use it to find specific places, check opening hours, and get photos for any coordinate or city. It turns your agent into a local expert for travel, real estate, and marketing research. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_SKONivLUcTFGx0U3glOVjDaopX2cLUvZfZs3ABeK/ai-agent-connect - **Tags:** geospatial-data, poi-search, location-intelligence, venue-data, routing, mapping ## Description Imagine you're planning a multi-city road trip or researching the commercial density of a new neighborhood. Usually, this involves opening dozens of tabs, cross-referencing maps, and scrolling through endless reviews to see if a place is actually worth visiting. This Connector changes that by giving your AI agent direct access to a massive database of local venues. You can just tell your agent to find every boutique hotel in a specific zip code or ask what people actually think about a hidden jazz club in the city. It handles the heavy lifting of pulling venue details, photos, and human-written tips in one go. You get straight answers instead of a list of links you have to click. Because Vinkius makes it easy to manage these connections, you can pull this data into your workflow without any technical friction. It turns your chat window into a powerful research station where you can audit neighborhood vibes, verify business hours, and gather visual proof for projects instantly. You can even define specific boundaries to see what exists physically adjacent to a target landmark or search for places that match very specific categories. It takes the guesswork out of location discovery. ## Tools ### autocomplete_venues Get fast typeahead suggestions to help your agent predict what location you're looking for. It speeds up the discovery process for common queries. ### list_venue_categories See the full list of official Foursquare categories. This helps you filter your searches accurately using the correct taxonomy. ### get_place_photos Pull media URLs for a specific venue so your agent can describe or show the location's look. It provides visual context to your data. ### get_place_details Grab the full metadata for a venue including ratings, hours, and specific location attributes. It gives you a complete picture of any spot. ### get_place_tips Fetch the latest human-written reviews and tips to understand the actual experience of a place. It captures the vibe that ratings alone miss. ### search_nearby_venues Find all the places within a certain distance of a specific GPS point. It is perfect for identifying nearby amenities quickly. ### search_within_polygon Identify every venue inside a specific set of coordinates or a custom-drawn shape. This is great for precise neighborhood analysis. ### search_within_radius Look for locations within a specific distance from a center point using rich schema scopes. It helps define a clear search area. ### search_places Search the entire Foursquare database for specific types of venues or keywords. It is the primary way to find new points of interest. ### match_venue_exactly Use this to force the agent to find one specific venue when a search result is ambiguous. It ensures you get the correct node every time. ## Prompt Examples **Prompt:** ``` Find a highly-rated Italian restaurant in Brooklyn near the waterfront. ``` **Response:** ``` I found 3 highly-rated Italian spots near the Brooklyn waterfront: | Venue | Rating | Distance | | :--- | :--- | :--- | | **L'Artusi** | 4.8 | 0.4 miles | | **Bammy** | 4.6 | 0.8 miles | | **Pasta Place** | 4.5 | 1.2 miles | Would you like to see the opening hours or recent photos for L'Artusi? ``` **Prompt:** ``` What are the opening hours for the Brooklyn Museum? ``` **Response:** ``` The **Brooklyn Museum** is open today! * **Hours:** 10:00 AM - 5:00 PM * **Rating:** 4.7/5 * **Note:** It is currently open and accepting visitors. Would you like me to find some nearby coffee shops for your visit? ``` **Prompt:** ``` Show me some tips from people who visited the High Line. ``` **Response:** ``` Here is what people are saying about **The High Line**: * "Go early to avoid the massive crowds." * "The rooftop view is incredible, but make sure to check out the hidden gardens." * "Don't miss the art installations in the middle section." I found over 50 tips like these to help you plan your walk. ``` ## Capabilities ### Find specific venues Search for businesses by name, category, or specific keywords in any city. ### Get high-resolution photos Pull media URLs to see what a location looks like before you visit. ### Check real-time hours Verify opening times and ratings for any venue instantly. ### Read human reviews Access tips and sentiments left by real people to gauge the atmosphere. ### Search by shape Identify every venue inside a specific set of coordinates or a custom polygon. ### Get autocomplete suggestions Get fast typeahead results to help your agent understand your intent quickly. ## Use Cases ### Real Estate Market Analysis An analyst asks the agent to find all coffee shops and parks within a specific city block to judge neighborhood walkability and amenities. ### Multi-City Travel Planning A user asks for a 3-day itinerary in Tokyo, and the agent pulls nearby sushi spots with high ratings and photos for each day. ### Competitive Marketing Research A brand manager asks for the top-rated gyms in a 5-mile radius to identify potential competitors for a new location. ### Location Schema Debugging A developer uses the agent to check if a specific venue's metadata matches the schema they need for their own location-based app. ## Benefits - Stop copy-pasting hours. Use get_place_details to get accurate opening times instantly for any business. - Get real human feedback. Use get_place_tips to see what people actually think about a venue before you go. - Visualize your search. Use get_place_photos to get a visual sense of a location without leaving your chat. - Precision mapping. Use search_within_polygon to analyze specific neighborhoods or city blocks with high accuracy. - Better search results. Use match_venue_exactly to eliminate duplicates and get the correct venue node every time. - Faster navigation. Use autocomplete_venues to help your agent understand user intent from just a few letters. ## How It Works The bottom line is you get instant access to local venue data without leaving your chat. 1. Subscribe to this Connector via the Vinkius Marketplace. 2. Enter your Foursquare API Key from your developer console. 3. Ask your agent to find places, check hours, or gather local tips. ## Frequently Asked Questions **Can the Foursquare MCP help me plan a road trip?** Yes, it can. You can ask your agent to find highly-rated landmarks, hotels, and restaurants along a specific route or in specific cities to build your itinerary. **How does the Foursquare MCP find venues near specific coordinates?** It uses geospatial queries to identify every business and point of interest within a specific radius or custom shape around any GPS pin you provide. **Can I use the Foursquare MCP to see photos of a business?** Absolutely. The Connector can pull high-resolution images for specific venues, allowing your agent to describe the look and feel of a place. **Does the Foursquare MCP include user reviews?** It pulls human-written tips and sentiments. This gives you a real sense of the atmosphere and quality of a venue based on actual visitor experiences. **Can the Foursquare MCP help with real estate market research?** Yes, it's a great tool for auditing neighborhood density. You can identify every venue in a specific city block to assess walkability and local amenities. **How do I get the specific hours for a store using the Foursquare MCP?** Just ask your agent for the opening hours of a specific store. It will pull the official hours directly from the venue's metadata for you. **Can my agent search for places within a specific drawn area (polygon)?** Yes. Use the 'search_within_polygon' tool. Provide a coordinate string representing the multi-point geometry. The agent will analyze the localized boundaries and restrict the POI lookup strictly inside that drawn area. **How do I retrieve the opening hours and ratings for a venue via chat?** Use the 'get_place_details' tool. Provide the Foursquare ID (fsq_id). The agent will fetch the full payload including operating hours, average ratings, and price levels natively from the places graph. **Can I see photos and user tips for a specific store through the agent?** Absolutely. Use the 'get_place_photos' and 'get_place_tips' tools. Your agent will pull dynamic image URLs and capture raw text sentiments left by other visitors to help you evaluate venue quality flawlessly.