search_places
ActiveTool of Foursquare
Search Foursquare places. Combine `query` (e.g., "coffee", "hardware store") with a location anchor — either `near` ("Brooklyn, NY") or `latitude`+`longitude`. Returns name, fsq_place_id, categories, address, distance, lat/lon, popularity.
Parameters schema
{
"type": "object",
"examples": [
{
"near": "Brooklyn, NY",
"sort": "RELEVANCE",
"limit": 10,
"query": "coffee"
},
{
"sort": "DISTANCE",
"limit": 20,
"query": "hardware store",
"latitude": 40.7128,
"radius_m": 1000,
"longitude": -74.006
}
],
"required": [],
"properties": {
"near": {
"type": "string",
"description": "Place name anchor (\"Brooklyn, NY\", \"Tokyo\")"
},
"sort": {
"enum": [
"RELEVANCE",
"DISTANCE",
"RATING",
"POPULARITY"
],
"type": "string",
"description": "RELEVANCE (default) | DISTANCE | RATING | POPULARITY"
},
"limit": {
"type": "number",
"description": "Results (1-50, default 10)"
},
"query": {
"type": "string",
"description": "Free-text query"
},
"latitude": {
"type": "number",
"description": "Center latitude (pair with longitude)"
},
"radius_m": {
"type": "number",
"description": "1-100000 metres (only with lat/lon)"
},
"longitude": {
"type": "number",
"description": "Center longitude"
},
"categories": {
"type": "string",
"description": "OPTIONAL. Comma-separated numeric fsq_category_id values ONLY (e.g. from a prior search_places result). Do NOT invent IDs or pass category names — use the `query` text for that (e.g. query:\"coffee\"). Unknown IDs are ignored."
}
}
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
Foursquare
https://github.com/pipeworx-io/mcp-foursquare
1/7 registries