# Foursquare MCP for AI Agents AI Agent Connect > Foursquare MCP lets your AI agent pull real-time location data, audit venue details, and gather community tips. It turns complex venue discovery into a conversational flow, allowing you to search for places, check photos, and see what people are saying about specific spots without leaving your chat interface. ## Overview - **Category:** data-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_fMoEt2lZWwjGJP6tPsfv7q41U93cuwU9aS9JM2yi/ai-agent-connect - **Tags:** location-data, venue-discovery, poi-search, metadata, geospatial-data ## Description This location data MCP lets you understand exactly what a neighborhood looks like or what the vibe of a specific coffee shop is like before you launch a new service. Instead of opening multiple tabs, searching for a business, and scrolling through dozens of reviews, you just ask your agent. This Connector connects your agent to one of the most reliable location databases in the world. You can have your agent scout out a city for specific categories, find the best-rated spots nearby, or even see what actual customers are saying about the atmosphere. It’s like having a real-time scout that can pull photos, addresses, and community sentiment in seconds. Whether you’re doing deep market research to see where your competitors are clustered or just trying to plan a trip based on local tips, this makes the data accessible. It takes the friction out of geographic research by pulling everything into a single conversation. By using this through the Vinkius catalog, you get a direct line to high-quality venue data that usually requires jumping through hoops in a dashboard. It’s about making location intelligence a natural part of your workflow. You can move from broad geographic queries to specific venue audits without ever leaving your chat interface. This tool turns high-level questions into actionable data points, whether you're checking category trends or looking for specific amenities in a new region. ## Tools ### autocomplete_places Get naming suggestions for places. This helps your agent find the correct venue names quickly. ### get_nearby_places Find venues based on coordinates. Use this to see what's in a specific neighborhood or area. ### get_place_details Get specific info for a venue. This pulls the metadata like addresses and categories for a single spot. ### get_place_photos Get images for a venue. Use this to see the vibe and aesthetic of a location instantly. ### get_place_tips Get community reviews and tips. This helps you understand public sentiment and highlights for a spot. ### list_categories List all Foursquare venue types. Use this to see the full scope of categories available in the data. ### search_places Search for places on Foursquare. This is the primary way to find venues by name, category, or location. ## Prompt Examples **Prompt:** ``` Find some highly rated pizza places in Brooklyn and show me what people say about them. ``` **Response:** ``` I've found some top-rated pizza spots in Brooklyn. Here's a summary of what people are saying: | Venue | Rating | Community Highlights | | :--- | :--- | :---| | **L'Industria** | 4.8 | "Amazing sourdough crust" and "great outdoor seating" | | **Roberta's** | 4.7 | "Bestthin crust in the city" and "cozy atmosphere" | | **Lucali** | 4.9 | "Authentic flavors" and "highly recommended for late night" | Would you like to see the photos for any of these? ``` **Prompt:** ``` I'm looking for coffee shops near 40.7, -74.0. Can you list the top 5 with their addresses? ``` **Response:** ``` I found 5 highly-rated coffee shops near those coordinates: 1. **Blue Bottle Coffee** - 40.707, -74.008 2. **Stumptown Coffee Roasters** - 40.712, -74.010 3. **Variety Coffee Bar** - 40.715, -74.005 4. **Devoción** - 40.720, -74.012 5. **Toby's Coffee** - 40.718, -74.009 Would you like the specific categories or photos for any of these locations? ``` **Prompt:** ``` What kind of businesses are usually listed in the Foursquare database? ``` **Response:** ``` Foursquare covers a massive range of venue categories. Here are some of the primary types you can query: * **Food & Drink:** Restaurants, Cafes, Bars, Bakeries * **Retail:** Boutiques, Grocery Stores, Malls * **Services:** Salons, Gyms, Dry Cleaners * **Entertainment:** Cinemas, Parks, Museums * **Travel:** Hotels, Airports, Landmarks I can list the full categories for you if you'd like to see the complete list. ``` ## Capabilities ### Find venues by name or category Search for specific types of businesses or locations instantly. ### See nearby spots Get a list of places based on specific coordinates or locations. ### View venue photos Pull images to understand the interior and exterior of a location. ### Read community tips Get real-time feedback and reviews from actual visitors. ### Get location details Pull specific metadata like addresses and categories for a venue. ### Get naming suggestions Use autocomplete to find the correct spelling of a place. ### Browse venue categories See the full range of business types available in the database. ## Use Cases ### Mapping Competition A researcher asks the agent to find all 'coffee shops' in a specific zip code to see where competitors are clustered. ### Service Verification An ops lead asks the agent to check if 'dry cleaners' are correctly categorized in a new city to ensure data accuracy. ### Trip Planning A traveler asks for the best-rated 'taco spots' near a specific hotel and wants to see the photos for the top three. ### Market Trend Analysis An analyst asks the agent to list all categories in a city to understand the diversity of the local economy. ## Benefits - Stop manual searching: Use search_places to find venues instantly instead of browsing multiple websites. This saves you from opening dozens of tabs just to see what businesses are in a specific area. - Instant visual context: Use get_place_photos to see what a location looks like without clicking through external links. You can get a sense of the interior design and exterior vibe in a single glance. - Real-time sentiment: Pull community feedback with get_place_tips to understand what people actually like about a spot. It gives you a pulse on the atmosphere and specific highlights from actual visitors. - Accurate naming: Use autocomplete_places to ensure your agent is looking at the correct business every time. This prevents your agent from getting confused by similar names or slightly different spellings. - Geospatial mapping: Use get_nearby_places to quickly identify all the businesses in a specific set of coordinates. This is perfect for mapping out a neighborhood or checking local density for a project. - Category exploration: Use list_categories to find the exact classifications you need for your market research. You can see the full scope of business types available to ensure your data is accurate. ## How It Works The bottom line is you get instant access to a massive global location database without ever leaving your AI chat window. 1. Subscribe to the Foursquare MCP on Vinkius. 2. Provide your Foursquare API key in your agent's configuration. 3. Ask your agent to search, audit, or list locations in any supported client. ## Frequently Asked Questions **Can I use the Foursquare MCP to find local businesses?** Yes, you can ask your agent to search for any venue by name, category, or location. It pulls real-time data to help you identify specific spots quickly. **Does the Foursquare MCP show photos of places?** Yes, it pulls images so you can see the atmosphere and aesthetics of a venue instantly. This is great for getting a visual sense of a location without leaving your chat. **Can my agent read reviews with the Foursquare MCP?** It pulls community tips and reviews, giving you a clear sense of public sentiment and highlights. You'll see what actual visitors are saying about a venue. **How does the Foursquare MCP help with market research?** It allows you to audit venue distributions and category trends across different geographic areas quickly. You can see where competitors are clustered in seconds. **Can I find places near specific coordinates using Foursquare MCP?** Yes, you can provide coordinates to the agent to get a list of all nearby venues. This is perfect for mapping out a specific neighborhood or area. **Is the Foursquare MCP good for travel planning?** It's great for finding highly-rated spots and reading local tips to build a better itinerary. You can see the best-rated places and their vibes before you arrive. **How do I find my Foursquare API Key?** Log in to the [**Foursquare Developer Console**](https://foursquare.com/developers/apps), create a Project, and you will find your API Key there. Copy and paste it into the field below. **Can the agent search for places near me?** Yes. Use the `search_places` tool providing the `ll` (latitude, longitude) or `near` (city name) parameters. Your agent will return matching venues instantly. **Is it possible to retrieve venue photos via the agent?** Yes. The `get_place_photos` tool allows your agent to fetch images for any venue by providing its Foursquare Place ID, helping you visualize the location.