MapRouter MCP server

Maps your agent can set up, and a bill that can't run away.

This MCP server lets a coding agent add a working map to an app: it creates MapRouter keys, geocodes addresses, and writes MapLibre code for HTML, React, Vue or Svelte. MapRouter is prepaid, so the agent can read usage and lower budgets but can never add credits or raise a budget.

Use the hosted server (recommended)

No key to copy: it signs you in with GitHub.

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

Claude Code plugin

This repo is also a Claude Code plugin marketplace. The plugin adds the hosted server and an add-a-map skill:

/plugin marketplace add maprouter-dev/maprouter-mcp
/plugin install maprouter@maprouter

Run it locally

For clients that only run local servers. (The npm package is not published yet; until then, clone this repo and point your client at node src/stdio.ts.) Create a secret key at https://app.maprouter.dev.

{
  "mcpServers": {
    "maprouter": {
      "command": "npx",
      "args": ["-y", "maprouter-mcp"],
      "env": { "MAPROUTER_SECRET_KEY": "mr_sk_..." }
    }
  }
}

Requires Node 22.18 or later.

Tools

Map data © OpenStreetMap contributors.

Use it as a library

import { MapRouterClient, createServer, handleMcpRequest } from 'maprouter-mcp';

const client = new MapRouterClient({ key: process.env.MAPROUTER_SECRET_KEY! });
// Any web-standard server: Workers, Deno, Bun, Node 22+.
export default { fetch: (request: Request) => handleMcpRequest(request, client) };

Licence

MIT