Skip to main content
MCP server CX Codex

Ultimaps — Claude Code MCP server: maps from data

Ultimaps — an MCP server that renders choropleths, category maps and pins from region names and values. Works without an API key, saves images locally.

MIT ★ 1 updated 2026-10-20

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http mcp https://api.ultimaps.com/mcp
Open on GitHub

What Ultimaps does

The agent gets a render_map tool that draws maps: colors countries, states, counties or ZIP codes by numbers (choropleth), categories or explicit colors, adds pins, title and legend. Region names are matched fuzzily and every correction is reported. Two other tools, list_maps and get_map_regions, provide a map catalog and region lists, but agents rarely need them: render_map accepts names, codes and aliases directly.

Without an API key, the keyless tier gives 30 renders per hour, PNG up to 1600 px with attribution. A key from Ultimaps Studio unlocks a plan: free tier — 500 renders per month, Pro — 5,000 and SVG without attribution. The image is returned in the response when it fits and always written to <tmpdir>/ultimaps-mcp/. Besides the local npm package, a hosted server at https://api.ultimaps.com/mcp works the same way but requires no Node.js.

What it helps with

  • draw a choropleth of US states by population
  • color EU countries by currency
  • pin five offices on a map of Europe
  • build an unemployment map for France's regions
  • preview region name matching before rendering

Example prompts for the agent

  • Map US states by population
  • Color EU countries by their currency
  • Show unemployment rates for California, Texas and New York on a map

How to install Ultimaps

1Platform CLI: remote server

claude mcp add --transport http mcp https://api.ultimaps.com/mcp

2Platform CLI

claude mcp add --env ULTIMAPS_API_KEY=<ULTIMAPS_API_KEY> --transport stdio ultimaps -- npx -y @ultimaps/mcp

Replace <…> with your own values

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Ultimaps

How to install Ultimaps in Claude Code?

The command claude mcp add --transport http ultimaps https://api.ultimaps.com/mcp adds the hosted server. For a local server with a key, use claude mcp add --env ULTIMAPS_API_KEY=<ULTIMAPS_API_KEY> --transport stdio ultimaps -- npx -y @ultimaps/mcp.

What does Ultimaps do?

The server draws maps: choropleths (values per region), category maps (labels) and pins. The agent sends region names and values, the server renders PNG or SVG and saves the file locally.

Do I need an API key for Ultimaps?

Without a key, the server uses the keyless tier: 30 renders per hour, PNG up to 1600 px with attribution. A key from Ultimaps Studio gives monthly quotas and removes attribution; a Pro key enables SVG and larger sizes.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open