Skip to main content
Glama
git-ksk

maps-browser-mcp

by git-ksk

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MAPS_CDP_PORTNoReuse an already-running CDP endpoint
MAPS_HEADLESSNoRun Chrome headlessfalse
MCP_HTTP_HOSTNoHTTP bind address127.0.0.1
MCP_HTTP_PORTNoHTTP port8787
MCP_BEARER_TOKENNoOptional bearer-token guard
MAPS_MAX_AX_NODESNoMaximum number of accessibility nodes to walk during read120
MCP_ALLOWED_HOSTSNoAccepted Host header nameslocalhost,127.0.0.1
MAPS_MAX_READ_CHARSNoMaximum character budget for read summary1800
MCP_ALLOWED_ORIGINSNoOptional exact Origin allowlist
MAPS_CHROME_EXECUTABLENoChrome/Chromium executableauto-detect
INTERACTIVE_ASSIST_MODENoEnable V3 bounded readingfalse
MAPS_CHROME_PROFILE_DIRNoDedicated profile directory~/.maps-browser-mcp/chrome-profile
MAPS_MAX_ACTIONS_PER_MINUTENoProcess-level action guard30

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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 4.0+) and a closed Rating menu are verified while preserving the expected search query. Interactive Assist must be enabled.

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 in|out. Success requires the same search/query plus an exact one-level zoom change in the public Maps URL. Interactive Assist must be enabled.

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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

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