# MapRouter

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: maprouter-dev
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/maprouter-dev/maprouter-mcp
- Updated: 2026-10-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/maprouter

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.maprouter.dev/mcp`
- Environment variables: `MAPROUTER_SECRET_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.maprouter.dev/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env MAPROUTER_SECRET_KEY=<MAPROUTER_SECRET_KEY> --transport stdio maprouter -- npx -y maprouter-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add maprouter --url https://mcp.maprouter.dev/mcp
```

2. **Platform CLI**
```bash
codex mcp add maprouter --env MAPROUTER_SECRET_KEY=<MAPROUTER_SECRET_KEY> -- npx -y maprouter-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "maprouter": {
            "url": "https://mcp.maprouter.dev/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "maprouter": {
            "command": "npx",
            "args": [
                "-y",
                "maprouter-mcp"
            ],
            "env": {
                "MAPROUTER_SECRET_KEY": "<MAPROUTER_SECRET_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "maprouter": {
            "type": "http",
            "url": "https://mcp.maprouter.dev/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "maprouter": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "maprouter-mcp"
            ],
            "env": {
                "MAPROUTER_SECRET_KEY": "<MAPROUTER_SECRET_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http maprouter https://mcp.maprouter.dev/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e MAPROUTER_SECRET_KEY=<MAPROUTER_SECRET_KEY> maprouter npx -y maprouter-mcp
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [agentgeo](https://affpapa.org/en/nevibecode/mcp/agentgeo.md) — MCP server · 2313 installs
- [openstreetmap-mcp-server](https://affpapa.org/en/nevibecode/mcp/openstreetmap-mcp-server.md) — MCP server · ★ 9 repo stars
- [amazon-location-service](https://affpapa.org/en/nevibecode/skills/amazon-location-service.md) — skill · 1300 installs
- [maps](https://affpapa.org/en/nevibecode/skills/maps.md) — skill · 437 installs
- [OpenStreetMap](https://affpapa.org/en/nevibecode/mcp/openstreetmap.md) — MCP server · ★ 6 repo stars
- [mapbox-search-integration](https://affpapa.org/en/nevibecode/skills/mapbox-search-integration.md) — skill · 2000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
