# Mapulus — how to use (mcp.ai)

Connect your Mapulus account and use 3 tools for developer tools straight from your AI agent. Connect with your own API key. Mapulus is a platform that enables users to create, manage, and analyze interactive maps, integrating with various applications to automate tasks and leverage location insights.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_mapulus?ms=1787295660000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `mapulus_find_location_with_external_id`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/mapulus`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/mapulus/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/mapulus/find/location/with/external/id` — Find locations by their external identifier. Returns a list of locations that match the provided external_id. External IDs are unique identifiers used for integrating Mapulus with external systems (CR
  - body: { external_id: string }
- `POST https://api.mcp.ai/api/mapulus/get/map/details` — Tool to retrieve detailed information about a map. Use when you have a map_id and need full map metadata.
  - body: { map_id: string }
- `POST https://api.mcp.ai/api/mapulus/list/maps` — Retrieves a paginated list of all maps accessible to the authenticated user. Supports filtering by name/tag and sorting by various fields. Returns map metadata including IDs, titles, and timestamps. U
  - body: { tag?: string, name?: string, page?: integer, sortBy?: string, perPage?: integer, sortOrder?: string }

## Example prompts
- "What can I do in Mapulus?"
- "Show me a summary of my Mapulus account"

## More
- Page: https://mcp.ai/mapulus
- Agent spec (llms.txt): https://mcp.ai/mapulus/llms.txt
- Postman collection: https://mcp.ai/mapulus/postman.json