Open Places API
Place search for AI agents and developers on open Overture data, with results you can keep.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"places": {
"url": "https://app.openplacesapi.com/mcp"
}
}
}Remote endpoints
https://app.openplacesapi.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (2)
🟢search_places(q, category, lat, lon, radius_mi, ...)
Search real-world places (businesses, landmarks, venues) near a latitude/longitude. Returns names, structured addresses, categories, coordinates, and distances in miles, ranked by relevance then distance. Backed by open Overture Places data. Global coverage wherever the current Overture release has indexable Places data; quality varies by location. Pass q (free text), category (an exact Overture category slug such as 'pharmacy'), or both; at least one is required. A q that names a kind of place ('pharmacy', 'coffee near me', 'boots pharmacy') also searches that category: meta.interpreted_as says how q was read, and each result's match field says whether it matched by name, address, category, or name_and_category. Use mode=name to match q literally against names only. Use list_categories to find valid category slugs instead of guessing. This is proximity search only: it cannot geocode street addresses or autocomplete partial input. Each call counts as one search from the prepaid balance. Read meta.warnings: category_alias reports a reviewed legacy category resolved to resolved_category (legacy parent aliases can narrow the old filter), unknown_category lists suggested categories, no_results_within_radius includes nearest_match identifying the closest place found within the bounded 100-mile lookup, outside results, and says which radius_mi to retry with or to search from a closer point beyond the 50-mile maximum, query_relaxed means no exact matches so a loosened q was used, category_inferred means nothing matched by name so the results are nearby places in the closest category (not the named place), pagination_limit_reached means more places match beyond the 1,000-place category-browse window so narrow the search instead of paging. If a call fails with quota_exhausted, stop and tell the user instead of retrying.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 2,
"maxLength": 128,
"description": "Free-text search, e.g. 'ramen', 'Blue Bottle', 'pharmacy', '서울'. Category words in q also search that category unless mode=name or category is set. Use at least 3 searchable characters, or 2 contiguous CJK characters. Required unless category is supplied."
},
"category": {
"type": "string",
"maxLength": 128,
"pattern": "^[a-z0-9][a-z0-9_:-]{0,127}$",
"description": "Exact Overture category slug, e.g. 'pharmacy', 'coffee_shop', or a parent such as 'food_and_drink' (matches its subcategories). Find slugs with list_categories. Without q, lists places in this category by distance; with q, filters text matches to it."
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90,
"description": "Latitude of the search center."
},
"lon": {
"type": "number",
"minimum": -180,
"maximum": 180,
"description": "Longitude of the search center."
},
"radius_mi": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 50,
"description": "Search radius in miles, max 50. Default 25."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "Maximum results. 1-20 without category, 1-50 when category is supplied. Default 10."
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 999,
"description": "Pagination offset for category browsing; only valid with category. offset + limit must be at most 1000 (the first 1000 ranked places). Use meta.next_offset from the previous page; it is null on the last page. Each page is one search."
},
"min_confidence": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Only return places whose Overture confidence score is at least this value, 0-1."
},
"sort": {
"type": "string",
"enum": [
"relevance",
"distance"
],
"description": "Result order. 'relevance' (default) ranks by match quality, then distance. 'distance' returns the same matches nearest first; category pages then page by distance."
},
"mode": {
"type": "string",
"enum": [
"all",
"name",
"address"
],
"description": "Match q against names, addresses, or both. Default 'all' (also reads category words in q). 'name' matches names literally, without category interpretation. mode=address needs at least 4 searchable characters in q."
}
},
"required": [
"lat",
"lon"
],
"description": "Provide q, category, or both. lat and lon are always required.",
"additionalProperties": false
}🟢list_categories(q, limit)
Look up valid category slugs for search_places. Answered locally from the Overture category taxonomy; does not use the API key or count against quota. With q (e.g. 'pharmacy', 'coffee', 'ev charging'), returns the best-matching categories (default 20, max 100) with label, parent, and full hierarchy. Without q, returns a compact overview: the top-level groups and their direct subcategories. Prefer passing q; the full taxonomy has over 2,000 categories.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Words describing the kind of place, or a guessed slug, e.g. 'pharmacy', 'hardware store', 'firestation'."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Maximum matches when q is supplied, 1-100. Default 20. Ignored without q."
}
},
"additionalProperties": false
}Community
Evidence