From 53b273b1f1beb611c2f9744b9c3668bd529ae084 Mon Sep 17 00:00:00 2001 From: Matthew Podwysocki Date: Thu, 11 Jun 2026 13:37:23 -0400 Subject: [PATCH] docs(readme): add Location Grounding section with example prompts MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The ground_location_tool is the recommended entry point for coordinate-first queries (neighborhood, POI, reachability, routing), but the README didn't mention it. Add a Location Grounding subsection at the top of Example Prompts with four prompts — one per dispatch strategy — so readers see the tool's range without needing to read the source. Includes a TODO placeholder for the upcoming grounding blog post; a follow-up PR will swap that for the live link once published. Co-Authored-By: Claude Opus 4.7 --- README.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/README.md b/README.md index c3d7032..9f74436 100644 --- a/README.md +++ b/README.md @@ -57,6 +57,21 @@ For detailed setup instructions for different integrations, refer to the followi Try these prompts with Claude Desktop or other MCP clients after setup: +### Location Grounding + +For coordinate-first queries — _"what's near me"_, _"what neighborhood is this"_, _"what's reachable in N minutes"_ — use `ground_location_tool`. It composes reverse geocoding, category search, and isochrone in a single call, adaptively choosing the right strategy based on the query, and returns typed records (names, addresses, coordinates, distances, reachability polygons) with citations. + +Each of the four prompts below exercises a different strategy in one tool call: + +- **Neighborhood** — _"What neighborhood is 47.6097, -122.3408, and what's around me?"_ +- **POI** — _"Coffee shops within a 10-minute walk of 40.7580, -73.9855"_ +- **Region** — _"What can I reach in a 15-minute walk from 37.7749, -122.4194?"_ +- **Routing** — _"Closest routable point to drop someone off at 34.0522, -118.2437"_ + + + +A detailed walkthrough of the design and the trade-offs against web search is in the works; this section will link to it once published. + ### Location Discovery - "Find coffee shops within walking distance of the Empire State Building"