---
title: "Mapflow.ai integration for LuumenAI"
url: "https://www.luumen.ai/integrations/mapflow-ai/"
entity: SoftwareIntegration
category: "AI & automation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Mapflow.ai integration for LuumenAI

Run satellite imagery analysis and check the credit cost before anything starts

## What LuumenAI can do with Mapflow.ai

LuumenAI connects to Mapflow.ai with an API token and exposes 10 tools (8 read-only · 2 write). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 10 tools (8 read-only · 2 write)
- Plan: available on all plans
- Category: AI & automation

## About Mapflow.ai with LuumenAI

Connect Mapflow.ai and Luumen can read your projects, processing status, storage, and account limits without leaving the terminal. Ask what a run would cost, which models your account has, or whether imagery already exists for an area. Starting a processing consumes credits, so that step is previewed and held for your approval by default.

## Example tools

Read-only (8 in total):

- `MAPFLOW_DOWNLOAD_PROCESSING_RESULT` — Download a completed processing's vector result as a GeoJSON file, optionally restricted to one AOI.
- `MAPFLOW_ESTIMATE_PROCESSING_COST` — Estimate the credit cost of a v2 processing without starting it or consuming credits.
- `MAPFLOW_GET_ACCOUNT_CAPABILITIES` — Return the connected Mapflow account's credit balance, processing and storage limits, available AI models and optional blocks, and imagery providers.
- `MAPFLOW_GET_PROCESSING` — Get detailed status, progress, cost, errors, source configuration, and result-layer metadata for one current v2 processing.
- `MAPFLOW_GET_STORAGE_OVERVIEW` — Return custom-imagery storage limits and usage together with the account's mosaics, so an agent can select existing uploaded imagery without separate discovery calls.
- `MAPFLOW_LIST_PROCESSINGS` — List current v2 processings.
- `MAPFLOW_LIST_PROJECTS` — List projects visible to the connected account, including personal and shared or team projects and the IDs needed to scope processing operations.
- `MAPFLOW_SEARCH_IMAGERY_CATALOG` — Search external imagery providers linked to the connected account for scenes or mosaics intersecting a GeoJSON AOI.

Write and destructive (2 in total, approval required by default):

- `MAPFLOW_CREATE_PROCESSING` — CREDIT-CONSUMING: create and immediately start an asynchronous v2 imagery-analysis processing.
- `MAPFLOW_CREATE_PROJECT` — Create a Mapflow project container for organizing imagery-analysis processings.

## Frequently asked questions

### How does LuumenAI connect to Mapflow.ai?

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 Mapflow.ai on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default. Administrators configure that per tool.

### Is there an audit trail?

Every call to Mapflow.ai — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/mapflow-ai/