Quick Start

Install

# macOS via Homebrew
brew install mapular/tap/mapular

# or via pip
pip install mapular

Authenticate

mapular login

This opens a browser tab for the Auth0 device flow. After you approve, the token is stored at ~/.mapular/state.json. You only need to do this once.

Wire into your AI client

mapular install

This writes the MCP server config into:

• .mcp.json in your current directory (for Claude Code)
• Claude Desktop's config file (if installed)

After install, reopen Claude Code. Type /mcp — you should see all three servers listed as connected.

Verify it works

Run these three prompts in Claude Code to confirm each server is live:

All three should return results without errors.

Demo mode

If you skip mapular login, mapular-mpoi starts in demo mode with a bundled demo-berlin dataset. All seven MPOI tools work on this data — useful for exploration before you authenticate.

mapular-geo never requires credentials. mapular-admin requires a logged-in session.