mcp-foursquare
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mcp-foursquare
MCP server for Foursquare place search and discovery. Lets your AI assistant find venues, search for places near a location, look up place details, and get location context — all through the Foursquare Places API v3.
Status: Ready
Prerequisites
Bun runtime (
curl -fsSL https://bun.sh/install | bash)A Foursquare Developer account and API key
Related MCP server: Google Maps MCP Server
Install
git clone git@github.com:McCullonas/mcp-foursquare.git
cd mcp-foursquare
bun installConfiguration
The server requires one environment variable:
Variable | Required | Description |
| Yes | Foursquare v3 API token from your developer dashboard |
Get your API key at location.foursquare.com/developer. Free tier includes 1,000 calls/day.
Available Tools
search_near
Search for places near a named location (city, neighbourhood, landmark).
Parameters:
query— What to search for (e.g."coffee","museum")near— Named location (e.g."Edinburgh, UK","Soho, London")categories(optional) — Foursquare category IDs to filter bylimit(optional) — Max results (default 10)
search_near_point
Search for places near a specific latitude/longitude coordinate.
Parameters:
query— What to search forll— Coordinates as"lat,lng"(e.g."51.5074,-0.1278")radius(optional) — Search radius in metreslimit(optional) — Max results
place_snap
Get the most likely place at a given location — useful for geotagging.
Parameters:
ll— Coordinates as"lat,lng"accuracy(optional) — GPS accuracy in metres
place_details
Get comprehensive details about a specific place by its Foursquare ID.
Returns: description, phone, website, hours, rating, price level, menu link, photos, tips.
Parameters:
fsq_id— Foursquare place ID (from a search result)
get_location
Get an approximate location based on the user's IP address (via ip-api.com). Useful as a starting point when no explicit location is provided.
No parameters required.
MCP Client Configuration
Add to your settings.json (or claude_desktop_config.json):
{
"mcpServers": {
"foursquare": {
"command": "bun",
"args": ["run", "/path/to/mcp-foursquare/src/index.ts"],
"env": {
"FOURSQUARE_SERVICE_TOKEN": "your-token-here"
}
}
}
}Replace /path/to/mcp-foursquare with the absolute path to your clone.
Development
# Run directly
bun run src/index.ts
# Build (outputs to dist/)
bun build src/index.ts --outdir dist --target nodeLicence
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Routing, geocoding, places, matrix and map tools for location-aware AI workflows.
Search and explore a global travel points-of-interest catalog (cities, countries, POIs).
Live Google Maps business search, review, and photo data for AI agents over MCP.
Real places for your agent: search 2.5M+ travel places, list businesses, license place photos.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables location-aware AI agents to search for nearby places, get detailed place information including hours and ratings, and calculate routes with turn-by-turn directions using Google Maps APIs.22MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to access Google Maps services including places search, details, directions, geocoding, and nearby search through natural language.636 PyPI2MIT
- AlicenseNot gradedqualityDmaintenanceEnables searching for places and tourist activities using Foursquare and Amadeus APIs, integrated with Claude Desktop and OpenAI Agent SDK.MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to search and scrape Google Maps places data (name, rating, address, etc.) directly without an API key.1-