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

# Opencage integration for LuumenAI

Turn addresses into coordinates, and coordinates back into addresses

## What LuumenAI can do with Opencage

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

## Key facts

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

## About Opencage with LuumenAI

Ask where a site, a store, or an alerting IP's reported location actually is. OpenCage answers in the terminal: OPENCAGE_GEOCODE_FORWARD for address to coordinates, OPENCAGE_GEOCODE_REVERSE for the other direction, and GeoJSON, XML, JSONP, or Google v3 shapes when a downstream tool expects them. OPENCAGE_PING_OPENCAGE checks connectivity. Read-only, over an API key. Answers come back right away.

## Example tools

Read-only (7 in total):

- `OPENCAGE_GEOCODE_FORWARD` — Convert a human-readable address into geographic coordinates.
- `OPENCAGE_GEOCODE_GEOJSON` — Geocode addresses or coordinates and return results in GeoJSON FeatureCollection format.
- `OPENCAGE_GEOCODE_GEOJSONP` — Geocode an address and return results wrapped in a JavaScript callback function (JSONP format).
- `OPENCAGE_GEOCODE_GOOGLE_V3_JSON` — Perform forward geocoding and return results in Google Geocoding API v3 compatible JSON format.
- `OPENCAGE_GEOCODE_REVERSE` — Convert coordinates to a human-readable address.
- `OPENCAGE_GEOCODE_XML` — Geocode a location query and return results in XML format.
- `OPENCAGE_PING_OPENCAGE` — Check API health and connectivity.

## Frequently asked questions

### How does LuumenAI connect to Opencage?

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

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

### Is there an audit trail?

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

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