MCP server for Ultimaps: turn data into map images of countries, states, counties and ZIP codes
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add ultimaps --env ULTIMAPS_API_KEY='<ULTIMAPS_API_KEY>' -- npx -y @ultimaps/mcp~/.codex/config.toml
[mcp_servers.ultimaps]
command = "npx"
args = ["-y", "@ultimaps/mcp"]
env = { ULTIMAPS_API_KEY = "<ULTIMAPS_API_KEY>" }
# codex mcp add ultimaps --env ULTIMAPS_API_KEY='<ULTIMAPS_API_KEY>' -- npx -y @ultimaps/mcp~/.cursor/mcp.json
{
"mcpServers": {
"ultimaps": {
"command": "npx",
"args": [
"-y",
"@ultimaps/mcp"
],
"env": {
"ULTIMAPS_API_KEY": "<ULTIMAPS_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"ultimaps": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ultimaps/mcp"
],
"env": {
"ULTIMAPS_API_KEY": "<ULTIMAPS_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"ultimaps": {
"command": "npx",
"args": [
"-y",
"@ultimaps/mcp"
],
"env": {
"ULTIMAPS_API_KEY": "<ULTIMAPS_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"ultimaps": {
"command": "npx",
"args": [
"-y",
"@ultimaps/mcp"
],
"env": {
"ULTIMAPS_API_KEY": "<ULTIMAPS_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"ultimaps": {
"command": "npx",
"args": [
"-y",
"@ultimaps/mcp"
],
"env": {
"ULTIMAPS_API_KEY": "<ULTIMAPS_API_KEY>"
}
}
}
}Remote
claude mcp add --transport http ultimaps https://api.ultimaps.com/mcp --header 'Authorization: <AUTHORIZATION>'~/.codex/config.toml
[mcp_servers.ultimaps]
url = "https://api.ultimaps.com/mcp"
http_headers = { Authorization = "<AUTHORIZATION>" }
# codex mcp add ultimaps --url https://api.ultimaps.com/mcp~/.cursor/mcp.json
{
"mcpServers": {
"ultimaps": {
"url": "https://api.ultimaps.com/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"ultimaps": {
"type": "http",
"url": "https://api.ultimaps.com/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"ultimaps": {
"httpUrl": "https://api.ultimaps.com/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"ultimaps": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.ultimaps.com/mcp",
"--header",
"Authorization:<AUTHORIZATION>"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"ultimaps": {
"url": "https://api.ultimaps.com/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}Environment variables
ULTIMAPS_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.