Create choropleth, category and pin maps of countries, states, counties and ZIP codes as images.
MCPpedia last refreshed this data
com.ultimaps/mcp is an MCP server that create choropleth, category and pin maps of countries, states, counties and ZIP codes as images. Its tool list has not been published yet over stdio and http, requires no API key, and scores 89/100 on MCPpedia's security, maintenance and efficiency rubric.
Config is the same across clients - only the file and path differ.
{
"mcpServers": {
"ultimaps": {
"env": {
"ULTIMAPS_API_KEY": ""
},
"args": [
"-y",
"@ultimaps/mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Create choropleth, category and pin maps of countries, states, counties and ZIP codes as images.
This server supports HTTP transport. Be the first to test it - help the community know if it works.
Five weighted categories - click any category to see the underlying evidence.
No known CVEs.
Checked @ultimaps/mcp against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience - it helps other developers decide.
Sign in to write a review.
Others in maps
Enables AI assistants to control REAPER for mixing, mastering, MIDI and music production.
MCP server for MikroTik routers: firewall, NAT, routing, DHCP, DNS, WireGuard and more via SSH.
AI tools for EasyEDA Pro schematics, PCB placement and routing, SPICE simulation, and DRC.
I Ching hexagram analysis and geographic feng shui for Taiwan locations
MCP Security Weekly
Get CVE alerts and security updates for com.ultimaps/mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
An MCP server for Ultimaps. Ask Claude, Codex or any MCP client for a map and get the image back in the conversation. It covers choropleths from pasted numbers, category maps and pinned locations, for countries, states, provinces, counties, continents and the world.
"Map US states by population." · "Color the EU members by currency." · "Show France's regions with these unemployment rates: …" · "Pin our five offices on a map of Europe."
No account needed. Without an API key the server uses the keyless tier. Set ULTIMAPS_API_KEY for plan quotas and larger or unbranded output.
Using ChatGPT? Ultimaps is in ChatGPT's app directory: add Ultimaps in ChatGPT, then type @ in a conversation and pick Ultimaps. You don't need this package.
Can't run a local command? In claude.ai or any client that connects to remote MCP servers, add the hosted server instead: https://api.ultimaps.com/mcp. It has the same three tools and nothing to install. See Hosted server. This package is the local version: requests come from your own IP address with your own key, and every image is saved to a file on your computer.
| Tool | What it does |
|---|---|
render_map | Renders a map as an image (PNG, or SVG with a Pro key), shown inline when it is small enough. Choropleth (numbers), categories (labels) or explicit colors, plus pins, title, a legend with its own heading, theme, region labels (names, values or both) and extra layers. Region names are matched fuzzily, and every correction or miss is reported with suggestions. dryRun: true previews matching and the color plan without rendering. |
list_maps | The map catalog: {id, title, regionType, layers, regionCount, labels}, searchable with query. |
get_map_regions | One map's region keys and titles, 200 per page, searchable by key, title or alias. |
All three are read-only. Agents rarely need the discovery tools: render_map accepts region names, codes and aliases directly.
Requires Node.js 20 or newer.
claude mcp add ultimaps -- npx -y @ultimaps/mcp
# with a key:
claude mcp add ultimaps --env ULTIMAPS_API_KEY=um_live_… -- npx -y @ultimaps/mcp
codex mcp add ultimaps -- npx -y @ultimaps/mcp
# with a key:
codex mcp add ultimaps --env ULTIMAPS_API_KEY=um_live_… -- npx -y @ultimaps/mcp
Codex writes TOML, not the JSON below. The equivalent entry in ~/.codex/config.toml (or .codex/config.toml in a trusted project):
[mcp_servers.ultimaps]
command = "npx"
args = ["-y", "@ultimaps/mcp"]
Download ultimaps-<version>.mcpb from the latest release and open it: Claude Desktop installs it in one click and asks for the optional API key. Or add this to claude_desktop_config.json:
{
"mcpServers": {
"ultimaps": {
"command": "npx",
"args": ["-y", "@ultimaps/mcp"],
"env": { "ULTIMAPS_API_KEY": "" }
}
}
}
~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
"mcpServers": {
"ultimaps": { "command": "npx", "args": ["-y", "@ultimaps/mcp"] }
}
}
.vscode/mcp.json:
{
"servers": {
"ultimaps": { "type": "stdio", "command": "npx", "args": ["-y", "@ultimaps/mcp"] }
}
}
You don't need this package to use the hosted server. In ChatGPT, add the Ultimaps app from ChatGPT's app directory. In other clients, add the URL:
claude mcp add --transport http ultimaps https://api.ultimaps.com/mcp
# with a key:
claude mcp add --transport http ultimaps https://api.ultimaps.com/mcp \
--header "Authorization: Bearer um_live_…"
Clients