Skip to main content

Install

The server is published as @maproll/mcp and listed in the official MCP Registry as io.maproll/maproll. It needs Node 20 or newer and no credentials.

Claude Code​

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

Claude Desktop​

Settings → Developer → Edit Config, then add:

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

Restart Claude Desktop afterwards.

Cursor​

Add the same block to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json to make it available everywhere.

VS Code​

Add it to .vscode/mcp.json:

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

Any other MCP client​

The server speaks stdio. Run it directly:

npx -y @maproll/mcp

Checking it works​

Ask your assistant for a map — "map coffee consumption per capita" is a reasonable first test. You should get a rendered map back, plus a URL.

If nothing happens, check the tool list your client exposes; the server advertises four tools, create_map, add_layers, find_places and describe_options. If they are absent, the client did not start the server — usually a Node version below 20, or a config file in the wrong place.

Configuration​

VariableDefaultPurpose
MAPROLL_PLACES_URLhttps://mcp.maproll.io/placesWhere find_places resolves names. Override only for local development.

There is no API key today. Anonymous rendering is the point — a server that demands credentials before the first map is a worse introduction than one that just works.