# MapRouter

> MapRouter is a freemium MCP server for maps and travel. Add OpenStreetMap maps and geocoding from your coding agent, with prepaid spend caps. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://maprouter.dev/docs/mcp
- **Repository:** https://github.com/maprouter-dev/maprouter-mcp
- **MCP Registry name:** dev.maprouter/mcp
- **Categories:** maps and travel, developer tools
- **Listing updated:** 2026-11-14

## About

MapRouter's server lets a coding agent set up maps end to end: it creates an origin-locked publishable key and a secret key, returns env lines, geocodes addresses and writes MapLibre code for HTML, React, Vue or Svelte. Every call goes through the public API, so it is metered and capped like your own app.

The design point is spend control. MapRouter is prepaid, with 10,000 free credits a day and packs of $5, $20 or $50. Agents can read usage and lower a key's daily or monthly cap, but they cannot add credits or raise a budget; a request to raise a cap is refused with raise_not_allowed. At zero balance requests return HTTP 402 and nothing is billed.

Use the hosted server at mcp.maprouter.dev, which signs you in with GitHub, or run the npm package locally with a secret key. Today it covers tiles, geocoding, autocomplete and time zones; routing is not available yet. The code is MIT licensed.

## Features

- **Project setup:** setup_project creates a publishable key locked to your origins plus a secret key.
- **Map code generation:** get_map_snippet writes MapLibre code with markers for four front-end frameworks.
- **Geocoding:** Convert addresses to coordinates and back, with autocomplete.
- **Time zones:** Return the IANA zone, UTC offset and daylight saving at a point.
- **Budget controls:** Agents can lower key caps but never raise them or buy credits.
- **Claude Code plugin:** A plugin adds the hosted server and an add-a-map skill.

## Good for

- Add a working map to a web app from a prompt
- Geocode a list of addresses in a script
- Look up the time zone for a coordinate
- Cap a key's daily spend before handing it to an agent
- Check remaining credits and free quota

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.maprouter.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.maprouter.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.maprouter.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.maprouter.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.maprouter.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.maprouter.dev/mcp"
    }
  }
}
```

## Tools

- `setup_project`: Create a publishable key and a secret key and return env lines.
- `geocode`: Convert an address or place to coordinates (10 credits).
- `reverse_geocode`: Convert coordinates to an address.
- `autocomplete`: Suggest completions for partial input (2 credits).
- `timezone`: Return IANA zone, UTC offset and DST at a point (1 credit).
- `get_map_snippet`: Generate MapLibre code with markers.
- `check_usage`: Show balance, free quota and key caps.
- `set_key_budget`: Lower a key's daily or monthly cap.

## FAQ

### Can an agent run up my bill?

No. Agents cannot add credits or raise a cap, and requests pause with a 402 when the balance reaches zero.

### What does the free tier include?

10,000 credits a day, about 500 map views or 1,000 geocodes; accounts under 30 days old get 2,000.

### Does it do routing?

Not yet; routing is planned with no date.

### What data does it use?

OpenStreetMap, so the attribution is required and geocoding results may be stored under the ODbL.

### Is MapRouter free?

MapRouter has a free plan, with paid plans for more usage or features.

### How do I add MapRouter to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.maprouter.dev/mcp

### What are the best alternatives to MapRouter?

The closest alternatives to MapRouter are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/maprouter
