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

# Geocodio integration for LuumenAI

Geocode US and Canadian addresses in bulk, and clean up old Geocodio lists

## What LuumenAI can do with Geocodio

LuumenAI connects to Geocodio with an API token and exposes 7 tools (6 read-only · 1 destructive). 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: 7 tools (6 read-only · 1 destructive)
- Plan: available on all plans
- Category: Source control & CI/CD

## About Geocodio with LuumenAI

Connect Geocodio and the agent can turn addresses into coordinates and coordinates back into addresses, one at a time or ten thousand at once. Useful when you are reconciling site inventories, checking asset locations, or normalizing address data before a migration. Luumen authenticates with an API key. List deletion is a separate, approved step.

## Example tools

Read-only (6 in total):

- `GEOCODIO_BATCH_REVERSE_GEOCODE` — Batch reverse geocode up to 10,000 coordinates in one request.
- `GEOCODIO_GEOCODE_BATCH` — Batch geocode up to 10,000 addresses to coordinates in one request.
- `GEOCODIO_GEOCODE_GOOGLE_MAPS_COMPATIBLE` — Geocode addresses using Google Maps-compatible API format.
- `GEOCODIO_GET_COORDINATES_FOR_BATCH_REVERSE_GEOCODE` — Utility tool that returns a predefined list of sample US coordinates (latitude,longitude strings).
- `GEOCODIO_SINGLE_GEOCODE` — Forward geocode a single address.
- `GEOCODIO_SINGLE_REVERSE_GEOCODE` — Reverse geocode a single coordinate.

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

- `GEOCODIO_DELETE_LIST` — Permanently deletes a Geocodio spreadsheet list by its ID.

## Frequently asked questions

### How does LuumenAI connect to Geocodio?

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 Geocodio on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 1 action classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

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

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