Skip to content
MCP server

Maproll

Make embeddable static maps from an assistant: choropleths, markers and routes as URLs

Runs locallyStatus and history
Pricing
Free
Platforms
CLI, API
Runs
Locally
Version
0.2.4
Listing updated
3 days ago

About Maproll

Maproll is a free MCP server for maps and travel. It runs locally on your machine and is started by your AI client.

Maproll's server hands back a permanent URL instead of a file in a temp folder, and that URL is the map's state. Pass it to add_layers and you get a new URL with the addition applied, so a map is built up over several turns. Each result includes svg_url, png_url, an editor_url to continue by hand, a ready embed tag and warnings for unrecognised region ids.

Four tools cover the work. create_map shades regions by number, paints flat colours or buckets categories; add_layers adds markers, routes, proportional circles, labels and pattern fills; find_places resolves a place name to coordinates and an ISO or IATA code, because models recall coordinates badly; describe_options lists the scopes, themes, icons and projections the renderer accepts. Sea routes follow the Suez, Panama and Malacca lanes.

It runs from npm with npx -y @maproll/mcp on Node 20 or newer, with no signup. Free maps carry a maproll wordmark; an API key from app.maproll.io removes it, while OpenStreetMap attribution stays.

Install

Run in a terminal

claude mcp add maproll -- npx -y @maproll/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "maproll": {
      "command": "npx",
      "args": [
        "-y",
        "@maproll/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "maproll": {
      "command": "npx",
      "args": [
        "-y",
        "@maproll/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "maproll": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@maproll/mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "maproll": {
      "command": "npx",
      "args": [
        "-y",
        "@maproll/mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "maproll": {
      "command": "npx",
      "args": [
        "-y",
        "@maproll/mcp"
      ]
    }
  }
}

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

create_map
Builds a map from countries, regions or values.
add_layers
Adds markers, routes, circles, labels and patterns to a map URL.
find_places
Resolves place names to coordinates and region codes.
describe_options
Lists accepted scopes, themes, icons and projections.

What it does

URL as state
Every map is a permanent URL that later tool calls extend.
Choropleths and highlights
Shade by value, colour regions or sort into categories.
Layered additions
Markers, routes, circles, labels and patterns.
Place lookup
Resolves names to coordinates and region codes.
Renderer options
Lists valid themes, icons and projections.

Good for

  • Map a statistic for the ten largest countries
  • Draw a shipping route with port markers
  • Compare two country groups on a dark map
  • Embed a map in a README or newsletter

Pricing

Free

Free without a key; a key removes the wordmark.

Prices change. Check maproll.io before you buy.

Maproll FAQ

Do I need an account?

No. It works without signup or key.

How do I remove the wordmark?

Create an API key in the editor and set MAPROLL_API_KEY; signing in alone does not remove it.

What does it need to run?

Node 20 or newer and npx.

Can I keep editing a map?

Yes, editor_url opens it in the maproll editor.

Is Maproll free?

Yes. Maproll is free to use.

How do I add Maproll to Claude Code?

Run this command in your terminal: claude mcp add maproll -- npx -y @maproll/mcp

What are the best alternatives to Maproll?

The closest alternatives to Maproll are HyperFrames by HeyGen, ffmpeg-skill, Tutu eSIM, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

Alternatives to Maproll

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. Tutu eSIM

    MCP server

    Live travel eSIM plans, prices and roaming costs for 190+ countries

    • 5 tools
    • Remote
    • Paid
    • Maps and travel
  4. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  5. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media