MapNetwork MCP Server
This server generates styled map images, computes routes, and allows re-downloading maps with different settings. You can:
Generate map images (PNG/SVG) from a place name, coordinates, or a list of markers; customize with radius, bounding box, and 11 color themes
Compute walking or driving routes between two locations and overlay them on maps
Place markers/pins on maps
Re-download previously generated maps instantly in a different theme or format without regenerating data
Customize canvas size and edge weight
Open maps in the MapNetwork web editor for further editing
Save maps to the Downloads folder (or get links for remote use)
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MapNetwork MCP Server Generate a map around Shibuya Station"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
English | 日本語
mapnetwork-mcp
MCP server for MapNetwork — turn places in Japan into styled, illustration-like map images (PNG / SVG), directly from Claude or any MCP-compatible AI assistant.
Maps are built from detailed OpenStreetMap data served by MapNetwork's own Overpass API for Japan, so coverage is currently limited to Japan (country code JP) — requests for places outside Japan return an error.
Since MapNetwork is built for Japan, a Japanese version of this README is also available: README.ja.md.
Features
Generate a map from a place name or a list of markers
Overlay a walking / driving route between two places
11 color themes (white, darkBlue, darkGreen, popArt, lightBlue, lightGreen, beige, magenta, gray, black, brown)
PNG or SVG output, saved to your Downloads folder
Slow-to-generate maps are handled automatically —
generate_*tools poll internally, anddownload_mapcan pick up a job later if neededRe-download a previously generated map in a different theme or format without regenerating
Open any generated map in the MapNetwork web editor for manual customization
View any generated map in 3D — each result includes a link that draws a 3D rendering of the map in your own desktop browser and shows it as an image (not available on mobile devices)
Related MCP server: geolabel-mcp
Example Usage
Prompt: "城崎温泉の外湯を地図にして。" (Make a map of the public bathhouses of Kinosaki Onsen.)
The map it generated, saved to your Downloads folder:
The result also includes three links. Open them in a browser to get more out of the same map — no need to regenerate.
Download link — change the color theme by editing the link's colorSet parameter (here &colorSet=black):
View 3D link — a 3D rendering of the map, drawn in your desktop browser and shown as an image:
Open in editor link — customize the map by hand in the MapNetwork web editor (here: buildings hidden, patchwork turned on, and the popArt color theme applied):
Installation
Claude Desktop
Using the .mcpb extension file (recommended)
The easiest way to install is via the .mcpb extension file available on the Releases page.
Download the latest
.mcpbfile from the Releases page.Open Claude Desktop and go to Settings → Extensions.
Drag the downloaded
.mcpbfile onto the Extensions panel to install.
Manual configuration
Add the following to your claude_desktop_config.json:
{
"mcpServers": {
"mapnetwork": {
"command": "uvx",
"args": ["mapnetwork-mcp"],
"alwaysAllow": ["generate_map", "generate_markers_map", "generate_route_map", "download_map", "redownload_map"]
}
}
}If you use pip instead of uvx:
pip install mapnetwork-mcp{
"mcpServers": {
"mapnetwork": {
"command": "mapnetwork-mcp"
}
}
}Remote MCP Server
You can also use MapNetwork through MCP without installing anything, via the remote MCP server:
https://mapnetwork.app/mcpIn Claude, go to Settings → Connectors → Add custom connector and register the URL above.
The key difference from this local server is how you receive the generated map image. Since mapnetwork-mcp runs on your PC, it can save the generated image directly to your Downloads folder. The remote server can't do this — most AI assistants are unable to properly display or save tool-result images within the chat — so instead of image data, it returns a text response with three links at mapnetwork.app: a download link for the PNG, a link to edit the map, and a link to view the map in 3D (the 3D rendering is drawn in your own desktop browser and shown as an image after a few seconds; it is not available on mobile devices). Open the links in a browser to view or save the image, to edit the map, or to see it in 3D. The local server returns the same three links after saving the PNG.
Tools
Tool | Description |
| Generate a styled map image centered on a single place and save it to Downloads |
| Generate a map with multiple pinned locations |
| Compute a walking or driving route between two places and generate a map with it overlaid |
| Check a pending |
| Re-download a previously generated map in a different color theme or format — instant, no regeneration |
Example prompts
Japanese
"東京タワー周辺の地図を作って"
"上野駅が最寄りの美術館・博物館を地図にして"
"赤坂駅から赤坂氷川神社までの徒歩ルートを地図にして"
"その地図を darkBlue テーマでSVG画像で出し直して"
"生成した地図の編集用リンクをください"
English
"Generate a map around Tokyo Tower"
"Show a map of the museums near Ueno Station"
"Show a walking route from Akasaka Station to Akasaka Hikawa Shrine on a map"
"Redownload that map as an SVG in the darkBlue theme"
"Give me a link to edit the generated map"
Links
Web UI: https://mapnetwork.app
Web UI Manual: https://mapnetwork.app/manual
API docs: https://mapnetwork.app/openapi.json
mcp-name: io.github.toruproject/mapnetwork-mcp
Available Tools
5 toolsdownload_mapAInspect
Check a pending generate_* job and download it once ready. If it's already done, returns the image immediately; otherwise waits internally (checking periodically) before returning — no need to wait between calls yourself. If still not ready when it returns, call it again with the same dataKey.
Example: download_map(data_key="20260618aBcDeFgHiJ")
Inputs: data_key (required).
generate_mapAInspect
Generate a styled map centered on a single place.
Example: generate_map(place="Tokyo Station")
Inputs: place (required), name.
generate_markers_mapBInspect
Generate a map with multiple pinned locations.
Example: generate_markers_map(markers=[{"label": "Tokyo Tower", "link": "https://www.tokyotower.co.jp/"}, {"label": "Zojoji Temple"}])
Inputs: markers (required), name, place.
generate_route_mapAInspect
Compute a walking/driving route between two places and generate a map with it overlaid. Both endpoints are pinned on the map automatically — do not also call generate_markers_map for them.
Example: generate_route_map(from="Tokyo Station", to="Tokyo Tower", mode="walking")
Inputs: to (required), from (required), mode, name, +1 more.
redownload_mapAInspect
Re-download a prior map in a different color theme or format — instant, no regeneration.
Example: redownload_map(data_key="20260618aBcDeFgHiJ", color_set="black")
Inputs: data_key (required), format, color_set.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a clearly distinct operation: single-place maps, multi-marker maps, route maps, downloading a pending result, and re-downloading with different styling. The overlap between generate_map and generate_markers_map is minimal and the descriptions make the boundary clear.
All tool names follow a consistent verb_noun pattern using snake_case: generate_map, generate_markers_map, generate_route_map, download_map, redownload_map. The verb prefix clearly communicates the action while the noun identifies the target.
Five tools is well-scoped for a map generation server. Each tool covers a necessary part of the workflow—generating different map types, fetching results, and re-styling prior outputs—without redundancy or bloat.
The tool surface covers the full expected lifecycle: generate maps in three distinct forms, retrieve the async result, and re-download existing maps in alternate themes or formats. There are no obvious dead ends or missing core operations for the declared purpose.
Maintenance
Related MCP Connectors
Location tools for Claude and other MCP clients, strongest in the US and Great Britain. Geocode whole lists with a confidence score per row, filter by distance, get road distances and drive-time areas, and plan multi-driver routes with Google Maps links. Check flood zones, crime and live warnings, find nearby places and UK registers (NHS, CQC, food hygiene), and keep shareable maps. Reads and writes Google Sheets. Free: sign in with Google.
Routing, geocoding, places, matrix and map tools for location-aware AI workflows.
Render static locator maps (area highlight, places, routes) and search places from AI assistants.
Geocoding, routing, isochrones, traffic, weather, and place search for AI agents. 19 MCP tools.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceConverts addresses to GPS coordinates and creates map visualizations using the Geoapify API, allowing Claude users to generate GeoJSON data and map images from location lists.4-
- AlicenseAqualityDmaintenanceTurn GPS coordinates into place name, category, and live opening hours via OpenStreetMap. Works in Claude, Hermes Agent, OpenClaw, and any MCP client.11MIT
- AlicenseAqualityDmaintenanceA Model Context Protocol (MCP) server that wraps the Amap (高德地图) Web Service APIs, giving AI assistants like Claude Code 9 map tools: geocoding, route planning (driving/transit/walking/cycling), POI search, nearby search, distance measurement, and IP location.1226 npm1MIT
- FlicenseAqualityDmaintenanceGives Claude and other MCP clients access to Google Maps Platform: geocoding, place search, place details, directions, distance matrix, and elevation.7-