mcp-gmap/rs
The world. Within reach.
Google Maps for your terminal and your agents. One Rust binary. Every coordinate, a possibility.
cargo install mcp-gmap-rs --locked01 / ONE BINARY, THREE WAYS IN
Fits the way you work.
From a quick lookup to a production agent. The same tools, wherever you run them.
Your terminal.
Find a place, validate an address, plan a route. Structured JSON. Scripts welcome.
mcp-gmap-rs geocode↗02 / STDIOYour agent.
Launch an MCP stdio server. Connect your host. Give your agent a sense of place.
mcp-gmap-rs serve stdio↗03 / HTTPYour infrastructure.
Streamable HTTP, native TLS and mTLS. Ready for containers and Kubernetes.
mcp-gmap-rs serve http↗02 / THE TOOLKIT
A world of answers.
42 tools. From street-level details to the conditions overhead. Every parameter, default and example is documented.
geocode
Convert an address or landmark to coordinates.
validate_address
Validate and standardize a postal address; returns Google's verdict, corrections, components and geocode. A verdict is evidence, not a delivery guarantee.
pollen
Get 1-5 days of pollen forecasts, indices and health recommendations for exact coordinates. Coverage varies by location and season.
area_insights
Count places within a circle, region or polygon using Places Aggregate. Optional place IDs are available only for counts of 100 or less; no automatic details requests.
snap_to_roads
Snap an ordered GPS path of 2-100 points to roads. Keep consecutive points within about 300 metres for good results. Optional interpolation adds road geometry.
nearest_roads
Find the nearest road segments for 1-100 independent GPS points; preserves Google's originalIndex and road place IDs.
reverse_geocode
Convert coordinates to a street address.
search_places
Search Places (New) by text with optional location and rating filters.
search_nearby
Find places around an address or exact coordinate pair, filtered by type, rating, and opening status.
place_details
Get full place details, reviews and attribution. Optional photo URLs retain author attribution. Display source/disclosure metadata alongside content.
directions
Get directions, route geometry, navigation instructions and travel duration.
distance_matrix
Compute travel distances and durations for multiple origins and destinations.
elevation
Get elevation in meters for geographic coordinates.
timezone
Get timezone, UTC/DST offsets and local time. timestamp is Unix milliseconds.
weather
Get current weather, daily forecast or hourly forecast.
air_quality
Get air quality indices, optional pollutant concentrations and health recommendations.
static_map
Fetch a PNG map with markers and paths. MCP returns an inline image; CLI returns base64 JSON or writes --output.
batch_geocode
Geocode up to 50 addresses with per-address success or error and bounded concurrency.
explore_area
Resolve a location and explore categories with details for top results. Use specific landmarks for trip planning.
plan_route
Plan a route through 2-27 stops. Optimize 2-25 intermediate stops, except transit. Exact coordinates are preserved.
compare_places
Search and compare places with detailed information and optional driving distance from userLocation.
search_along_route
Find places along a route using its encoded polyline.
local_rank_tracker
Track search rank across a geographic grid for 1-3 keywords; returns ARP, ATRP, SoLV and per-point errors.
speed_limits
Get posted automobile speed limits for up to 100 GPS points or road-segment place IDs. Restricted Google Asset Tracking license/access is required; enabling Roads alone does not grant access. Each returned limit can incur a separate charge. Data is not real-time or guaranteed accurate.
autocomplete
Get Places API (New) place and optional query predictions, with session tokens, language and geographic filters. Returns the full native Google JSON. Session billing requires a fresh token and a qualifying concluding Details or Address Validation request in the same project.
geolocate
Estimate device location and an accuracy radius from a native Google Geolocation body containing cell towers or WiFi access points. Requires an API key. IP fallback identifies this server's egress location, not the user; set body.considerIp=false to disable fallback.
solar
Retrieve Solar building insights, regional data layers, or a GeoTIFF asset by ID. Coverage, imagery quality and EEA terms vary; expanded-coverage experiments are pre-GA. Data-layer URLs are temporary and returned without credentials. GeoTIFF binary size is bounded by the executable's response limit.
aerial_view
Look up Aerial View playback URLs or free metadata by US postal address or video ID. lookup is billable; metadata omits playback URLs. Coverage is limited to supported US locations. Returns Google's original metadata and short-lived URLs; videos must not be downloaded, stored or cached.
render_aerial_video
Explicitly request asynchronous rendering of an Aerial View video for a supported US postal address. This mutates Google's render queue; an existing video returns metadata. Does not wait for completion or download video. Poll maps_aerial_view with operation metadata and then lookup for playback URLs.
map_tiles
Map Tiles sessions, 2D/3D imagery, viewport attribution and Street View tiles. Licensed for visualization only: do not use imagery for machine interpretation, analysis, extraction or offline maps. Preserve attribution and cache directives.
streetview
Get Street View Static metadata or a JPEG image by location or panorama ID. Preserve the Google attribution embedded in imagery and obey Street View usage policies.
streetview_publish
Manage the authenticated user's Street View photos and photo sequences, including bounded byte upload and publishing. Requires end-user OAuth consent with streetviewpublish scope; API keys and service accounts alone cannot authorize this tool. Create/update/delete operations change public imagery.
datasets
Manage geospatial datasets for Google Maps data-driven styling, including asynchronous imports from an existing Cloud Storage object.
route_optimization
Optimize delivery or service fleets with the actual Route Optimization API and an intact native ShipmentModel, including capacities, time windows and cost constraints.
air_quality_forecast
Retrieve hourly air quality forecasts for an explicit time or interval, up to 96 hours ahead.
air_quality_history
Retrieve historical air quality information from the previous 30 days.
air_quality_heatmap
Download a real air quality heatmap image tile for an index or pollutant.
pollen_heatmap
Download a real tree, grass or weed pollen index heatmap tile.
weather_history
Retrieve up to 24 previous hours of weather history with explicit pagination.
weather_alerts
Retrieve public weather alerts intersecting a location, including native severity and issuing-authority information.
weather_minute_forecast
EXPERIMENTAL: retrieve high-resolution precipitation forecasts over a six-hour timeframe.
weather_map
EXPERIMENTAL: download a precipitation nowcast image tile for the United States or Europe.
03 / FROM FIRST CALL TO PRODUCTION