MapShot MCP server for generating map screenshots with AI assistants
Single tool with generally good schema definition and parameter descriptions, but description clarity could be improved. Tool has proper JSON Schema with typed parameters and constraints. However, the description lacks some LLM-optimization patterns (no explicit WHEN to use guidance, no dependency hints). Error handling in the source is basic (try/catch with success message but no recovery guidance for edge cases).
Generate a screenshot of a map with specified coordinates, zoom level, and optional markers. Perfect for creating visual representations of locations, routes, or points of interest.
Tool description lacks LLM-optimized guidance. Missing explicit WHEN to use this tool (e.g., 'Call this to visualize geographic locations before planning routes'). No dependency hints or prerequisites stated. Description is 227 chars but reads as feature list rather than actionable guidance.
Error handling returns success message but lacks recovery guidance for common failure modes (invalid coordinates, marker out of bounds, file write permission denied, puppeteer launch failure). Source shows basic try/catch that will return raw errors. LLM receives no guidance on what to try next.
No documented output schema. Tool returns success/failure text but no structured response schema is visible. MCP tool registration shows input schema (MapScreenshotToolSchema) but output format is unspecified in the provided source. LLM cannot predict what fields to expect.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | C | 64 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 0 | - | v1 |
Parameters lack validation guidance in descriptions. 'center' is array [lat, lon] but description doesn't specify decimal degree range (-90 to 90 for lat, -180 to 180 for lon). 'zoom' has min/max (1-18) correctly specified, but width/height constraints (1-10000) are in schema but not explained in parameter description text that LLM reads.
File write operation (writeFileSync) has no safety guardrails. No directory traversal validation on outputPath parameter. Malicious agent could write to arbitrary filesystem locations. No description guidance on expected file path format or security constraints.