---
title: "Mapulus integration for LuumenAI"
url: "https://www.luumen.ai/integrations/mapulus/"
entity: SoftwareIntegration
category: "Source control & CI/CD"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Mapulus integration for LuumenAI

Read your Mapulus maps and locations from the terminal

## What LuumenAI can do with Mapulus

LuumenAI connects to Mapulus with an API token and exposes 3 tools (3 read-only). Every tool is read-only, so it can answer questions from Mapulus but cannot change anything in it. Read actions still follow the configured access and approval policy.

## Key facts

- Authentication: API token
- Tools available: 3 tools (3 read-only)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Source control & CI/CD

## About Mapulus with LuumenAI

Pull location context into the work you are already doing. Ask for the maps you can reach with MAPULUS_LIST_MAPS, open one with MAPULUS_GET_MAP_DETAILS, or match a site from your own records using MAPULUS_FIND_LOCATION_WITH_EXTERNAL_ID. Read-only, over an API key. Answers come back right away.

## Example tools

Read-only (3 in total):

- `MAPULUS_FIND_LOCATION_WITH_EXTERNAL_ID` — Find locations by their external identifier.
- `MAPULUS_GET_MAP_DETAILS` — Retrieve detailed information about a map.
- `MAPULUS_LIST_MAPS` — Retrieves a paginated list of all maps accessible to the authenticated user.

## Frequently asked questions

### How does LuumenAI connect to Mapulus?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Mapulus on its own?

No. Every one of the 3 tools is read-only, so LuumenAI can answer questions from Mapulus but cannot change anything in it. Read actions still follow the configured access and approval policy.

### Is there an audit trail?

Every call to Mapulus is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/mapulus/