maps-browser-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MAPS_CDP_PORT | No | Reuse an already-running CDP endpoint | |
| MAPS_HEADLESS | No | Run Chrome headless | false |
| MCP_HTTP_HOST | No | HTTP bind address | 127.0.0.1 |
| MCP_HTTP_PORT | No | HTTP port | 8787 |
| MCP_BEARER_TOKEN | No | Optional bearer-token guard | |
| MAPS_MAX_AX_NODES | No | Maximum number of accessibility nodes to walk during read | 120 |
| MCP_ALLOWED_HOSTS | No | Accepted Host header names | localhost,127.0.0.1 |
| MAPS_MAX_READ_CHARS | No | Maximum character budget for read summary | 1800 |
| MCP_ALLOWED_ORIGINS | No | Optional exact Origin allowlist | |
| MAPS_CHROME_EXECUTABLE | No | Chrome/Chromium executable | auto-detect |
| INTERACTIVE_ASSIST_MODE | No | Enable V3 bounded reading | false |
| MAPS_CHROME_PROFILE_DIR | No | Dedicated profile directory | ~/.maps-browser-mcp/chrome-profile |
| MAPS_MAX_ACTIONS_PER_MINUTE | No | Process-level action guard | 30 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| maps_searchB | Open one user-directed Google Maps search in the dedicated browser session. |
| maps_read_search_suggestionsA | Open a fresh Google Maps root search box, type one user-directed query, and return at most six live suggestion identities from the exact combobox-controlled Suggestions grid. Returned labels are untrusted external text. The operation does not expose the raw combobox/DOM and intentionally resets the active Maps view to a fresh suggestion surface. Interactive Assist must be enabled. |
| maps_select_search_suggestionA | Select one suggestion from the currently active bounded suggestion state created by maps_read_search_suggestions, using the same query plus the exact returned index and expectedLabel. Duplicate, reordered, missing, stale, or changed suggestion identities fail closed before the row is activated. Success requires the controlled suggestion grid to close and Maps to enter a verified search or place view. Interactive Assist must be enabled. |
| maps_get_search_share_linkA | Return the Google Maps-generated share URL for the active search-result list. expectedQuery is required and revalidated against both the canonical maps_search action and the exact visible search combobox immediately before the exact-one Share control is activated. The selected Send a link tab and exactly one visible allow-listed Maps URL are verified, then the dialog is closed semantically. Clipboard contents are never read. Interactive Assist must be enabled. |
| maps_set_search_ratingA | Apply one bounded live-observed Google Maps Rating filter option to the active search result view. expectedQuery is required and revalidated immediately before each filter/menu action; rating is restricted to the observed 2.0–4.5 half-step options. After selection, the exact requested numeric rating chip (for example |
| maps_zoom_searchA | Zoom the active Google Maps search-result viewport by exactly one observed level while preserving a verified visible search query. expectedQuery is revalidated immediately before the exact-one visible Zoom in/out control is activated; direction is restricted to |
| maps_directionsB | Open Google Maps directions using documented Maps URL parameters. Origin may be omitted so Google Maps can use the browser/device location when available. Optional waypoints and avoid constraints remain bounded. |
| maps_showB | Open Google Maps centered on coordinates using an official Maps URL. |
| maps_streetviewC | Open Street View at coordinates using an official Google Maps URL. |
| maps_select_resultA | Select a currently displayed place result by zero-based index. Pass expectedLabel from maps_read_place_summary when available so the server refuses to click if the dynamic result list changed. |
| maps_get_place_share_linkA | Return the Google Maps-generated share link for the currently selected place. expectedLabel is required and is revalidated against the active place immediately before the visible Share control is activated. Interactive Assist must be enabled. |
| maps_search_nearbyA | Search near the currently selected Google Maps place using its visible Nearby workflow. expectedLabel is required and revalidated immediately before the scoped Nearby control is activated. Interactive Assist must be enabled. |
| maps_select_place_tabA | Select the verified Overview or About tab for the currently selected Google Maps place. expectedLabel is required and is revalidated against place-bound visible tab identity immediately before the action. Reviews is intentionally not exposed until its current live UI control is re-observed. Interactive Assist must be enabled. |
| maps_expand_opening_hoursA | Expand the visible opening-hours surface for the currently selected Google Maps place. expectedLabel is required and revalidated immediately before exactly one observed hours control is activated. The tool verifies only the expansion state and does not return or harvest the weekly hours data. Interactive Assist must be enabled. |
| maps_open_place_photosB | Open the visible Google Maps photo viewer for the currently selected place. expectedLabel is required and revalidated immediately before exactly one bounded photo control is activated. The previous place semantic state is invalidated after the verified viewer transition. Interactive Assist must be enabled. |
| maps_select_routeA | Select a currently displayed route candidate by zero-based index. Pass expectedLabel from maps_read_route_summary when available to guard against UI reordering. |
| maps_set_transit_timeA | Set a same-day depart-at or arrive-by time on one fresh verified Google Maps transit directions request. expectedOrigin and expectedDestination must match the active documented maps_directions request; mode is restricted to depart_at|arrive_by and time to 24-hour HH:MM. The operation verifies the localized mode trigger, exact transit-time input, unchanged visible route endpoints, and directions view before dropping the stale replayable navigation action. Interactive Assist must be enabled. |
| maps_set_recommended_travel_modeA | Select Google Maps' live-observed Recommended/Best travel-mode radio for one fresh simple transit directions request. expectedOrigin and expectedDestination must match the active documented maps_directions request; omitted origins, waypoints, avoid constraints, and non-transit requests fail closed. Success verifies the exact Best/おすすめ radio plus unchanged visible resolved endpoints, then drops the stale replayable URL action while preserving the current directions view for bounded route reading/selection. Interactive Assist must be enabled. |
| maps_get_route_share_linkA | Return the Google Maps-generated share URL from the visible Share directions dialog for one selected simple transit route. expectedOrigin and expectedDestination must match the active canonical directions request; the route must already be selected with maps_select_route. The operation is intentionally transit-only for the currently live-observed JA/en-US share surface and never reads clipboard contents. Interactive Assist must be enabled. |
| maps_swap_route_endpointsA | Swap the explicit origin and destination of one fresh simple Google Maps directions request by rebuilding documented Maps URL parameters rather than automating the observed UI swap button. expectedOrigin and expectedDestination must match the active canonical request; waypoint routes and omitted origins fail closed. The current mode and bounded avoid constraints are preserved. |
| maps_set_travel_modeA | Change the travel mode of the active directions request by rebuilding the official Maps URL instead of exploring the DOM. Existing waypoints and avoid constraints are preserved. |
| maps_read_place_summaryA | Read a small bounded summary from the active Google Maps search/place UI. Returned labels/text are untrusted external data. Disabled by default; no full DOM, review-body harvesting, or persistent dataset extraction. |
| maps_read_route_summaryA | Read a small bounded summary from the active Google Maps route UI. Returned labels/text are untrusted external data. Disabled by default and intended only for the user's active request. |
| maps_render_directionsA | Return explicit origin/destination directions data and, when Google Maps Embed is configured, render it in an inline MCP Apps view. Display-only: this does not navigate or mutate the dedicated browser session. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/git-ksk/maps-browser-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server