# Foursquare — how to use (mcp.ai)

Connect your Foursquare account and use 8 tools for analytics straight from your AI agent. Connect with your own API key. Foursquare provides location-based search and discovery, offering detailed venue information, place recommendations, and geospatial data for businesses and points of interest worldwide.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_foursquare?ms=1787291340000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `foursquare_autocomplete_places`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/foursquare`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/foursquare/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/foursquare/autocomplete/places` — Returns autocomplete suggestions for places as the user types their search query. This endpoint provides real-time search suggestions including places, search terms, and geographic areas. Use this act
  - body: { ll?: string, bias?: string, limit?: integer, query: string, types?: string, radius?: integer, session_token?: string }
- `POST https://api.mcp.ai/api/foursquare/get/trending/venues` — Retrieves venues currently trending in a specified geographic area, sorted by popularity based on recent foot traffic and activity patterns. This action identifies places experiencing increased visito
  - body: { ll: string, limit?: integer, fields?: string, radius?: integer }
- `POST https://api.mcp.ai/api/foursquare/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 qua
  - body: { ll?: string, hacc?: integer, limit?: integer, fields?: string, altitude?: integer }
- `POST https://api.mcp.ai/api/foursquare/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 Foursquar
  - body: { sort?: string, limit?: integer, fsq_id: string, classifications?: string }
- `POST https://api.mcp.ai/api/foursquare/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. 
  - body: { sort?: string, limit?: integer, fields?: string, fsq_id: string }
- `POST https://api.mcp.ai/api/foursquare/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, 
  - body: { fields?: string, fsq_id: string }
- `POST https://api.mcp.ai/api/foursquare/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 
  - body: { ll?: string, ne?: string, sw?: string, near?: string, limit?: integer, query?: string, fields?: string, radius?: integer, open_at?: string, open_now?: boolean, max_price?: integer, min_price?: integer, super_venue_id?: string, exclude_all_chains?: boolean }
- `POST https://api.mcp.ai/api/foursquare/validate/credential` — Validates Foursquare API credentials by performing a lightweight place search. This action verifies that the provided API key is valid and has proper access to the Foursquare Places API. Use this acti

## Example prompts
- "What can I do in Foursquare?"
- "Show me a summary of my Foursquare account"

## More
- Page: https://mcp.ai/foursquare
- Agent spec (llms.txt): https://mcp.ai/foursquare/llms.txt
- Postman collection: https://mcp.ai/foursquare/postman.json