Skip to main content

mapnetwork-mcp

MCP server for MapNetwork — generate styled map images (PNG / SVG) for any location on Earth, directly from Claude or any MCP-compatible AI assistant.

Features

  • Generate maps from a place name, a list of markers, or a walking/driving route
  • 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, and download_map can pick up a job later if needed
  • Re-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

Example Usage

Prompt: "Generate a map around the 21st Century Museum of Contemporary Art, Kanazawa."

Here is the map it generated: Map Drawing Example

Prompt: "Redownload that map in a few different color themes."

The same map, redownloaded in different color themes:

Dark Green Style Light Green Style Pop Art Style Black Style

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.

  1. Download the latest .mcpb file from the Releases page.
  2. Open Claude Desktop and go to SettingsExtensions.
  3. Drag the downloaded .mcpb file 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/mcp

In Claude, go to SettingsConnectorsAdd 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 a download link and a link to edit the map at mapnetwork.app. Open the links in a browser to view or save the image, or to edit the map.

Tools

Tool Description
generate_map Generate a styled map image centered on a single place and save it to Downloads
generate_markers_map Generate a map with multiple pinned locations
generate_route_map Compute a walking or driving route between two places and generate a map with it overlaid
download_map Check a pending generate_* job and download it once ready
redownload_map 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

mcp-name: io.github.toruproject/mapnetwork-mcp

Release files for mapnetwork-mcp 6.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mapnetwork-mcp 6.1.0
File Size Uploaded
mapnetwork_mcp-6.1.0.tar.gz 1.6 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for mapnetwork-mcp 6.1.0
File Interpreter ABI Platform
mapnetwork_mcp-6.1.0-py3-none-any.whl Python 3 none any Details

Total release size:1.6 MB

Release files / mapnetwork_mcp-6.1.0.tar.gz

Download URL mapnetwork_mcp-6.1.0.tar.gz
Size 1.6 MB
Tags Source
SHA-256 checksum
How to use checksums
77bd16c718a5168a643aad5e846de2f8b92526f059f6e10abb86757dbb1a0b9f
BLAKE2b-256 checksum
How to use checksums
33b78e4776910ce6162da0d8e459815b9daea6a7b5855d8e990ad59f2d005a4f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 31, 2026.

Transparency log

Release files / mapnetwork_mcp-6.1.0-py3-none-any.whl

Download URL mapnetwork_mcp-6.1.0-py3-none-any.whl
Size 12.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
161972e752dd7ae04638dcd891dd96d97a129e13b587f77020b5c15f2a4a1590
BLAKE2b-256 checksum
How to use checksums
c6e97eeecdd389fd93ce1912d7f4b87a370cf746c472b6bb4edfcb7ec63a048e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 31, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

6.1.0 This release

2 release files

6.0.0

2 release files

5.0.0

2 release files

4.0.0

2 release files

3.0.0

2 release files

2.0.0

2 release files

1.2.3

2 release files

1.2.2

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.0

2 release files

1.0.0

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page