Skip to content
MCP server

MapRouter

Add OpenStreetMap maps and geocoding from your coding agent, with prepaid spend caps

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.maprouter.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.maprouter.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools