MapRouter
Add OpenStreetMap maps and geocoding from your coding agent, with prepaid spend caps
- Pricing
- Freemium
- Platforms
- API, CLI
- Runs
- Locally or Remotely
- Version
- 0.1.1
- Listing updated
- 3 days ago
About MapRouter
MapRouter is a freemium MCP server for maps and travel. It can run locally on your machine or as a hosted remote server.
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.
Install
Run in a terminal
claude mcp add --transport http mcp https://mcp.maprouter.dev/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.maprouter.dev/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.maprouter.dev/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.maprouter.dev/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"serverUrl": "https://mcp.maprouter.dev/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"type": "http",
"url": "https://mcp.maprouter.dev/mcp"
}
}
}Configuration
MAPROUTER_SECRET_KEYA secret key (mr_sk_...) from app.maprouter.devRequired
Tools this server provides (8)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Freemium
10,000 free credits a day; prepaid packs from $5, no subscription
Prices change. Check maprouter.dev before you buy.
MapRouter 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 to MapRouter

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools