A sample Genkit application that integrates Google Maps MCP server for geocoding and location-based queries using the Gemini AI model
Single tool 'maps/maps_geocode' has a basic description but lacks critical schema documentation. The tool is registered in google-maps-flow.ts as a string reference ('maps/maps_geocode') with no visible input schema, parameter descriptions, or output schema in the provided source. The description 'Geocode an address to get latitude and longitude coordinates' is only 62 characters and provides minimal LLM guidance on when/how to use it. No parameter documentation, no error handling guidance, no output structure defined. Tool definition appears to be delegated to the external @modelcontextprotocol/server-google-maps package, making it impossible to verify schema quality from this repo alone.
Geocode an address to get latitude and longitude coordinates
No input schema visible for maps/maps_geocode. Tool is registered as a string reference only; actual schema definition is in external @modelcontextprotocol/server-google-maps package, not in this repo. Cannot verify parameter types, constraints, or descriptions.
Tool description is only 62 characters and lacks LLM-critical context: What format should the address be in? What does the output contain? When should this be called vs other maps tools? Descriptions should be 100-200 chars with WHAT/WHEN/RETURN guidance.
No output schema documented. LLMs cannot plan downstream tool calls without knowing what fields (latitude, longitude, address, etc.) the response contains. Baseline: 100% of A+ tools document return types.
No error handling guidance. If geocoding fails (invalid address, rate limit, API error), the LLM has no recovery path. Should include: 'If address not found, try a partial address or city name. If rate-limited, wait before retrying.'
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 30 | <=2025-11-25 | v2 |
Tool composition incomplete. Only 1 of 6 available Google Maps tools is registered (maps_geocode). Commented-out tools (reverse_geocode, search_places, place_details, distance_matrix, elevation, directions) suggest incomplete implementation. Sample should demonstrate full capability or explain why tools are disabled.