MapRouter — Claude Code MCP server: features and setup
MapRouter lets a coding agent build MapLibre maps, look up coordinates and find a location’s time zone. Use it when an app needs map features.
MIT updated 2026-10-28
claude mcp add --transport http mcp https://mcp.maprouter.dev/mcpWhat MapRouter does
The server creates MapRouter keys, turns addresses into coordinates and returns MapLibre map code with markers for HTML, React, Vue or Svelte. It can also look up an address from coordinates, suggest matches as someone types and report a point’s IANA zone, UTC offset and daylight-saving status.
Its tools show the account balance and key limits, and can reduce a daily or monthly cap. They cannot raise one. The hosted option signs in through GitHub; local use needs Node 22.18 or later and a MapRouter secret key.
What it helps with
- add a MapLibre map with markers to an app
- turn a street address into coordinates
- look up an address from a set of coordinates
- find the time zone for a map location
- inspect the balance and lower a key cap
Example prompts for the agent
- Add a MapLibre map with markers to this app.
- Find the coordinates for this address and mark the location on the map.
- Tell me the time zone and UTC offset for these coordinates.
How to install MapRouter
1Platform CLI: remote server
claude mcp add --transport http mcp https://mcp.maprouter.dev/mcp2Platform CLI
claude mcp add --env MAPROUTER_SECRET_KEY=<MAPROUTER_SECRET_KEY> --transport stdio maprouter -- npx -y maprouter-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add maprouter --url https://mcp.maprouter.dev/mcp2Platform CLI
codex mcp add maprouter --env MAPROUTER_SECRET_KEY=<MAPROUTER_SECRET_KEY> -- npx -y maprouter-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"maprouter": {
"url": "https://mcp.maprouter.dev/mcp"
}
}
}{
"mcpServers": {
"maprouter": {
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<MAPROUTER_SECRET_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"maprouter": {
"type": "http",
"url": "https://mcp.maprouter.dev/mcp"
}
}
}{
"servers": {
"maprouter": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"maprouter-mcp"
],
"env": {
"MAPROUTER_SECRET_KEY": "<MAPROUTER_SECRET_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http maprouter https://mcp.maprouter.dev/mcp2Platform CLI
gemini mcp add -e MAPROUTER_SECRET_KEY=<MAPROUTER_SECRET_KEY> maprouter npx -y maprouter-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 MapRouter
How do I install MapRouter in Claude Code?
For the hosted server, run claude mcp add --transport http maprouter https://mcp.maprouter.dev/mcp. Sign-in uses GitHub.
What does MapRouter do?
It helps an agent create MapRouter keys, geocode addresses and produce MapLibre map code. It also supports reverse geocoding and time-zone lookups.
What do I need to run MapRouter locally?
Local use requires Node 22.18 or later and a MapRouter secret key. The server can lower a key’s cap, but cannot increase it or add credits.