MCP FAQ

Any MCP-compatible AI assistant works: Claude Code, Claude Desktop, and Cursor are tested. The MCP protocol is an open standard — any client that implements it will work.

For mapular-mpoi and mapular-geo, no account is needed. Both servers run in demo mode by default with a bundled Berlin dataset. To access all regions and use mapular-admin, run mapular login once to authenticate.

mapular-mpoi ships with a bundled demo-berlin region — real location data for Berlin. This lets you explore all seven MPOI tools end-to-end without any credentials. Run mapular login to switch to API mode with access to all available regions.

POI data is available for 10 countries: Austria, Belgium, France, Germany, Luxembourg, Netherlands, Poland, Switzerland, United Kingdom, and the United States. Coverage expands regularly.

No. The demographics_fetch tool currently covers Germany only. It returns population by age band, household count, and purchasing power index for a configurable radius around any German coordinate.

Run mapular install --for /path/to/your/repo from the mapular-platform directory. This writes the server definitions to that repo's .mcp.json and approves them in ~/.claude.json. Without the approval entry, Claude Code silently ignores the servers even if they appear in .mcp.json.

The most common cause is a missing enabledMcpjsonServers entry in ~/.claude.json. Run mapular install --for /path/to/your/repo to add it automatically. Then restart Claude Code by closing the panel and opening a new conversation — pressing Enter in an existing chat does not reload servers.

Run mapular login once in your terminal. The admin server reads the stored session from ~/.mapular/state.json and refreshes tokens automatically — no environment variables needed for standard use. For CI pipelines, set MAPULAR_AUTH_MODE=m2m and supply Auth0 machine-to-machine credentials.