Static Map MCP Server

An MCP server that renders routes and markers on OpenStreetMap tiles and save as PNG.

Quick Start

Add to your MCP config:

{
  "mcpServers": {
    "staticmap": {
      "command": "uvx",
      "args": ["staticmap-mcp"]
    }
  }
}

Note

No API key required. Uses public OpenStreetMap tiles.

Tip

Pair with openroute-mcp to generate route coordinates from natural language prompts, then pass them to staticmap-mcp to render the map.

Available Tools

Tool	Description
render_route_map	Render a route on an OpenStreetMap tile map and save as PNG

Full tool reference

render_route_map

Render a route on an OpenStreetMap tile map and save as PNG.

• coordinates (list of [lon, lat], required): Route as list of [longitude, latitude] pairs, e.g. [[-17.1, 28.1], [-17.2, 28.2]]
• output_path (string, required): File path to save the PNG image (parent directories created automatically)
• markers (list of objects): Optional named points, each with lon, lat, and label keys
• width (int): Image width in pixels (default: 800)
• height (int): Image height in pixels (default: 600)
• line_color (string): Route line colour (default: "black")
• line_width (int): Route line width in pixels (default: 3)
• basemap (string): Map tile style — "osm" (default), "topo" (terrain/hiking), "cycle" (cycling), "humanitarian"

Development

git clone https://github.com/cvsouth/staticmap-mcp.git
cd staticmap-mcp
uv sync --dev
pytest

License

MIT