Place search for AI agents and developers on open Overture data, with results you can keep.
Maintained byopenplacesapi.com(verified)Also a maintainer?
Call this server's tools from your browser. Nothing to install.
Enter Bearer followed by a space and your Open Places API key.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
Words describing the kind of place, or a guessed slug, e.g. 'pharmacy', 'hardware store', 'firestation'.
Maximum matches when q is supplied, 1-100. Default 20. Ignored without q.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http places https://app.openplacesapi.com/mcp \ --header 'Authorization: Bearer YOUR_TOKEN'
Headers
Authorization (required): Enter Bearer followed by a space and your Open Places API key.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.
| Argument | Type | Description |
|---|---|---|
| q | string | Words describing the kind of place, or a guessed slug, e.g. 'pharmacy', 'hardware store', 'firestation'. |
| limit | integer | Maximum matches when q is supplied, 1-100. Default 20. Ignored without q. |
{
"type": "object",
"properties": {
"q": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Words describing the kind of place, or a guessed slug, e.g. 'pharmacy', 'hardware store', 'firestation'."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Maximum matches when q is supplied, 1-100. Default 20. Ignored without q."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| q | string | 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. |
| lat* | number | Latitude of the search center. |
| lon* | number | Longitude of the search center. |
| mode | string | 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. |
| sort | string | Result order. 'relevance' (default) ranks by match quality, then distance. 'distance' returns the same matches nearest first; category pages then page by distance. |
| limit | integer | Maximum results. 1-20 without category, 1-50 when category is supplied. Default 10. |
| offset | integer | 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. |
| category | string | 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. |
| radius_mi | number | Search radius in miles, max 50. Default 25. |
| min_confidence | number | Only return places whose Overture confidence score is at least this value, 0-1. |
{
"type": "object",
"required": [
"lat",
"lon"
],
"properties": {
"q": {
"type": "string",
"maxLength": 128,
"minLength": 2,
"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."
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude of the search center."
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude of the search center."
},
"mode": {
"enum": [
"all",
"name",
"address"
],
"type": "string",
"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."
},
"sort": {
"enum": [
"relevance",
"distance"
],
"type": "string",
"description": "Result order. 'relevance' (default) ranks by match quality, then distance. 'distance' returns the same matches nearest first; category pages then page by distance."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Maximum results. 1-20 without category, 1-50 when category is supplied. Default 10."
},
"offset": {
"type": "integer",
"maximum": 999,
"minimum": 0,
"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."
},
"category": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_:-]{0,127}$",
"maxLength": 128,
"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."
},
"radius_mi": {
"type": "number",
"maximum": 50,
"description": "Search radius in miles, max 50. Default 25.",
"exclusiveMinimum": 0
},
"min_confidence": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Only return places whose Overture confidence score is at least this value, 0-1."
}
},
"description": "Provide q, category, or both. lat and lon are always required.",
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 19, 2026.
No readOnlyHint / destructiveHint annotations, so clients can't tell a read from a write without asking.
Fix: Add annotations to each tool, e.g. { readOnlyHint: true } for tools that only read.