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
claude mcp add --transport http mcp https://api.ultimaps.com/mcpWhat 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/mcp2Platform CLI
claude mcp add --env ULTIMAPS_API_KEY=<ULTIMAPS_API_KEY> --transport stdio ultimaps -- npx -y @ultimaps/mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add ultimaps --url https://api.ultimaps.com/mcp2Platform CLI
codex mcp add ultimaps --env ULTIMAPS_API_KEY=<ULTIMAPS_API_KEY> -- npx -y @ultimaps/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"ultimaps": {
"url": "https://api.ultimaps.com/mcp"
}
}
}{
"mcpServers": {
"ultimaps": {
"command": "npx",
"args": [
"-y",
"@ultimaps/mcp"
],
"env": {
"ULTIMAPS_API_KEY": "<ULTIMAPS_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"ultimaps": {
"type": "http",
"url": "https://api.ultimaps.com/mcp"
}
}
}{
"servers": {
"ultimaps": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ultimaps/mcp"
],
"env": {
"ULTIMAPS_API_KEY": "<ULTIMAPS_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http ultimaps https://api.ultimaps.com/mcp2Platform CLI
gemini mcp add -e ULTIMAPS_API_KEY=<ULTIMAPS_API_KEY> ultimaps npx -y @ultimaps/mcpReplace <…> 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.