Skip to content
MODEL CONTEXT PROTOCOL

Your assistant can make maps now

Install one line of config and Claude, Cursor, VS Code or any MCP client can build a real statistical map — and hand you back a URL you can drop into a README, a story, or a newsletter. No API key. No signup.

A world choropleth of coffee consumption per capita, built by an AI assistant through the maproll MCP server

Install it

Add this to your MCP client config. That is the whole setup — the server runs from npm on demand.

{
  "mcpServers": {
    "maproll": {
      "command": "npx",
      "args": ["-y", "@maproll/mcp"]
    }
  }
}
col: h4: Claude Code p: claude mcp add maproll -- npx -y @maproll/mcp col: h4: Claude Desktop p: Settings -> Developer -> Edit Config, then paste the block above. col: h4: Cursor / VS Code p: Drop the same block into .cursor/mcp.json or your workspace .vscode/mcp.json.

What it can do

create_map

A map from your data. Choropleths, flat colour paints, qualitative categories, or a plain highlight of the regions you name.

add_layers

Markers, routes, proportional circles, pattern fills, labels. Sea routes follow the shipping lanes through Suez and Panama instead of cutting over land.

find_places

Real coordinates and the right region code for a place name. Models guess coordinates badly; this stops the marker landing in the wrong country.

describe_options

Every scope, theme, icon and projection the renderer accepts, so your assistant does not invent one that renders nothing.

Why it is a URL, not a file

Every map the server makes comes back as a permanent link. Put it in an image tag and it renders anywhere — a README, a docs page, an issue, a newsletter — with no JavaScript and no build step.

The same link opens in the maproll editor if you want to keep working on it by hand.

GET /map.svg?scope=world&data=FI:12,US:4.2&theme=dark

Free, and no key to get started

Anonymous maps carry the maproll wordmark. Sign in and it becomes yours to switch off, along with saving maps to a project.

Read the docs