developer-toolsapi_key

Foursquare

Foursquare provides location-based search and discovery, offering detailed venue information, place recommendations, and geospatial data for businesses and points of interest worldwide

Verdict

The Foursquare MCP gives your team location intelligence inside Switchy. @mention it to search for venues, pull place details, read user tips, or grab photos from Foursquare's database — useful when planning events, researching competitors, or building location-aware features. It surfaces POI data (ratings, categories, addresses) without leaving your Space. You'll need a Foursquare API key with Places API access. Coverage is strongest in urban areas; rural or newly opened venues may return sparse results.

Common use cases

  • Scout event venues in a new city
  • Pull competitor locations and ratings
  • Research foot traffic near retail sites
  • Gather user tips for travel itineraries
  • Validate addresses for location-based features

Integration

Vendor
Foursquare
Category
developer-tools
Auth
API_KEY
Tools
5
Composio slug
foursquare

Tools

  • Retrieve nearby places v3

    The getnearbyplaces endpoint retrieves a list of places near a specified location, primarily supporting check-in use cases and local discovery. it returns points of interest (pois) including lower quality results not found in the standard p

  • Retrieve place photos by id

    Retrieves photos associated with a specific place in foursquare's database. this endpoint allows you to access user-generated images for a particular point of interest (poi) using its unique foursquare id (fsq id). it's useful for enhancing

  • Retrieve places by id

    Retrieves detailed information about a specific place using its unique foursquare id (fsq id). this endpoint provides comprehensive data about a venue, including its name, address, category, ratings, tips, photos, and other relevant informa

  • Retrieve place tips using fsq id

    Retrieves user-generated tips for a specific place in the foursquare database. this endpoint allows you to fetch valuable insights and experiences shared by foursquare users about a particular venue. it's useful for enhancing location-based

  • Search places api request

    The getplacessearch endpoint allows you to search for places in the foursquare database based on various criteria such as location, keywords, and categories. this tool is ideal for discovering nearby points of interest or finding specific v

Setup

Setup guide

  1. 11. Go to the Foursquare Developer Portal and create a new app to generate an API key with Places API access. 2. In Switchy, open your workspace settings and navigate to the Integrations tab. 3. Click 'Add MCP' and select Foursquare from the list. 4. Paste your API key into the authentication field and click 'Connect'. 5. Return to any Space and type '@Foursquare search coffee shops near Pike Place Market' to test the connection. 6. If results appear, the MCP is live and ready to invoke any of its five tools by @mentioning Foursquare followed by your query.

What teammates see: by default, memories from Foursquare are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Find Nearby Restaurants

@Foursquare search for restaurants near 123 Main Street, Austin TX and return the top 10 results with ratings and cuisine types
Open in a Space →

Get Venue Details

@Foursquare retrieve full details for place ID 4b5e6f8a9c0d1e2f3a4b5c6d including address, category, hours, and phone number
Open in a Space →

Read User Tips

@Foursquare get user tips for place ID 5c7d8e9f0a1b2c3d4e5f6a7b and summarize the most common themes in the feedback
Open in a Space →

Collect Venue Photos

@Foursquare retrieve photos for place ID 6d8e9f0a1b2c3d4e5f6a7b8c and show me the five most recent images
Open in a Space →

Scout Event Locations

@Foursquare search for event spaces near downtown Seattle with capacity over 100 people and return venue names, addresses, and ratings
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@foursquare find coffee shops within 500 meters of 40.7580° N, 73.9855° W and show their ratings

Output

Found 8 coffee shops near that location. Top results: Blue Bottle Coffee (rating 8.9/10, 401 Broadway) is 120m away with 847 check-ins. Stumptown Coffee Roasters (rating 8.7/10, 18 W 29th St) is 340m away. La Colombe (rating 8.5/10, 270 Lafayette St) is 450m away. Each entry includes the venue's Foursquare ID, full address, primary category, and distance from your coordinates. This illustrative example shows typical proximity search results; actual venue availability and ratings vary by location and time.

Notes

This example demonstrates the core nearby-places search capability. Requires an API key with Places API access. Results are limited to Foursquare's venue database coverage—less populated in rural areas. Rate limits apply (typically 950 regular calls/day for free tier), so batch location queries when possible rather than making repeated single-coordinate searches.

Prompt

@foursquare get user tips and reviews for venue FSQ_ID_4b5e6f8a9c1d2e3f and summarize the top 3 themes

Output

Retrieved 47 user tips for this venue. Top themes: (1) Ambiance—12 tips praise the cozy outdoor seating and string lights, calling it 'perfect for dates.' (2) Specific menu items—9 tips recommend the truffle fries and craft cocktails, especially the Old Fashioned. (3) Service speed—8 tips note slow service during weekend brunch but efficient weeknight turnover. This illustrative summary shows how Foursquare tips surface crowd-sourced insights; actual tip volume and themes depend on venue popularity.

Notes

This example pairs Foursquare's tips endpoint with AI summarization to extract actionable patterns from user-generated content. Useful for competitive research or venue selection. Note that tip availability varies widely—popular urban venues may have hundreds of tips, while newer or niche locations may have few or none. The AI can only summarize what Foursquare users have contributed.

Prompt

@foursquare search for 'ramen' in Seattle and return the top 5 results with photos if available

Output

Found 23 ramen venues in Seattle. Top 5: Tsukushinbo (Capitol Hill, rating 9.1/10, 4 photos available), Danbo (University District, rating 8.8/10, 12 photos), Kizuki Ramen (multiple locations, rating 8.6/10, 8 photos), Ooink (Capitol Hill, rating 8.5/10, 6 photos), Yoroshiku (Wallingford, rating 8.4/10, 3 photos). Each result includes Foursquare ID for fetching full details or photo URLs. This illustrative example shows keyword-based search; actual results reflect current Foursquare database state and user activity.

Notes

This example showcases keyword search combined with photo retrieval—useful for building location-aware features or content curation. The search endpoint supports category filters and geographic bounds for precision. Photo availability depends on user contributions; not all venues have images. Consider caching photo URLs if displaying results in a UI, as fetching photos individually counts against your rate limit.

Use-case deep-dives

Field sales territory planning

When Foursquare beats manual prospecting for local outreach

A 6-person sales team covering three metro regions needs to identify coffee shops, coworking spaces, and retail clusters for cold outreach. The Foursquare MCP pulls venue lists by category and location, surfaces user tips to gauge foot traffic, and returns photos to pre-qualify spaces before a rep drives out. This works when your ICP hangs out in physical locations and you're doing 20-40 visits per week per rep. The API key auth means anyone on the team can query without OAuth friction. If your sales motion is purely digital or you're targeting enterprise accounts in office parks, skip this—Foursquare's strength is consumer-facing POIs, not B2B venue data. For teams doing boots-on-the-ground prospecting in dense urban markets, this MCP turns location scouting into a 10-minute Switchy query instead of a half-day Google Maps rabbit hole.

Event venue research for offsites

Foursquare narrows the shortlist when planning team gatherings

A remote-first startup planning quarterly offsites in rotating cities uses the Foursquare MCP to compile venue options—restaurants for team dinners, bars for happy hours, parks for outdoor sessions. The search tool filters by category and radius, tips reveal whether a spot handles groups well, and photos confirm the vibe before anyone books a site visit. This is the right call when you're researching 3-5 cities per year and need to move fast without hiring a local coordinator. The 5-tool scope keeps it simple: search, details, tips, photos, nearby. If your offsite budget is under $5k and you're just picking a restaurant, you don't need an MCP—Yelp in a browser is faster. For teams spending $15k+ on multi-day events and evaluating 10+ venues per city, Foursquare's structured data beats crowdsourced review sites. Run the query in Switchy, share the shortlist, vote in Slack.

Hyperlocal content research for marketing

When Foursquare feeds neighborhood storytelling at scale

A 3-person content team at a travel app writes neighborhood guides for 50 US cities. They use the Foursquare MCP to pull top-rated cafes, bookstores, and parks by zip code, then scrape user tips for color commentary and pull photos for social posts. The API key setup means interns can run queries without waiting on eng to provision OAuth. This works when you're producing 10+ guides per month and need structured POI data, not just editorial opinions. If you're writing one guide per quarter or covering international cities where Foursquare's coverage is thin, the juice isn't worth the squeeze—manually curating 20 spots is faster. For teams publishing at volume in North American metros, this MCP turns research from a 4-hour slog per guide into a 20-minute data pull. Pair it with a Google Sheets MCP to auto-populate your CMS.

Frequently asked

What does the Foursquare MCP do in Switchy?

It lets your AI agents search Foursquare's place database, pull venue details, photos, and user tips. You can query by location, category, or Foursquare ID. Useful for building location-aware features, researching venues for events, or enriching customer data with place context. The MCP wraps Foursquare's Places API v3, so you get the same POI data developers use in apps.

Do I need a Foursquare developer account to use this MCP?

Yes. You need a Foursquare developer account and an API key. Sign up at developer.foursquare.com, create a project, and copy the key into Switchy's connection flow. No OAuth dance—just paste the key. Anyone on your team with the key can connect it, but treat the key like a password since it grants full API access under your Foursquare quota.

Can the Foursquare MCP write reviews or check in to venues?

No. This MCP is read-only. It retrieves place data, photos, and tips that other users have already posted. You can't create check-ins, write new tips, or modify venue information through Switchy. If you need write access, you'd have to build a custom integration using Foursquare's full API outside of this MCP.

Why use this MCP instead of calling Foursquare's API directly?

The MCP handles auth, request formatting, and error parsing so your AI agents can query Foursquare in plain English. No need to write API client code or manage rate limits manually. If you're already building a custom app with Foursquare data, stick with the direct API. If you want agents to answer location questions on the fly, the MCP is faster.

Does Foursquare MCP usage count against my API quota?

Yes. Every tool call the MCP makes hits your Foursquare API quota. Foursquare's free tier allows 50 calls per day; paid plans scale up. Switchy doesn't impose extra limits, but if your team runs a lot of location queries, monitor your Foursquare dashboard to avoid hitting the cap mid-workflow.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.