Build a time-ordered itinerary whose geography, travel times, opening constraints, and along-route stops have been checked. Use the standalone CLI; no MCP connection is required.
Before calling the CLI
- On the first call in a session, or after an execution failure, read
../_shared/setup-and-diagnostics.mdand run the non-billable local preflight. - The user must supply
GOOGLE_MAPS_API_KEY. Never expose its value. - Read
../_shared/content-attribution.mdbefore presenting reviews, photos, or Google-generated summaries.
Workflow
- Establish destination, dates or duration, fixed anchors, mobility constraints, pace, and relevant preferences. Ask only for omissions that materially change the itinerary.
- Read
references/travel-planning.mdbefore designing the itinerary. - Use
maps_search_placesto find candidate anchors, then group nearby anchors into one-direction daily arcs. - Use
maps_search_along_routefor meals and breaks between anchors. Usemaps_place_detailsfor hours, ratings, and source metadata. - Validate every day with
maps_plan_routeormaps_directions. Do not present estimated timing as validated timing. - Check weather and air quality when they affect the plan. Respect regional weather limitations described in the reference.
- When useful, produce a numbered static map after the stop order is final.
- Present a day-by-day schedule with travel time, visit duration, reservations or opening-hour caveats, and clearly marked fallbacks.
CLI
npx -y @cablate/mcp-google-map exec <tool> '<json_params>'
For exact tool parameters, read ../google-maps/references/tools-api.md only for the tools selected by the plan.
Boundaries
- A request for only A-to-B directions or a simple multi-stop ordering belongs to
google-maps. - A request to assess business visibility or local search rankings belongs to
google-maps-local-seo. - Do not infer that a venue is accessible, open, safe, or suitable when the API response does not establish it.
- Do not silently substitute web estimates for unavailable Google Maps results; identify the alternate source.
References
references/travel-planning.md: required methodology, timing budgets, geographic arcs, and anti-patterns.../google-maps/references/tools-api.md: exact parameters and response shapes for selected tools.../_shared/setup-and-diagnostics.md: first-run and failure recovery.../_shared/content-attribution.md: Places presentation requirements.