Opencage
for LuumenAI

Turn addresses into coordinates, and coordinates back into addresses

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.

The Opencage toolbox

7 tools, all read-only. They answer instantly, and every call is logged.

  • ReadForward Geocode AddressConvert a human-readable address into geographic coordinates.
  • ReadGeocode to GeoJSONGeocode addresses or coordinates and return results in GeoJSON FeatureCollection format.
  • ReadGeocode with JSONPGeocode an address and return results wrapped in a JavaScript callback function (JSONP format).
  • ReadGeocode Google v3 JSONPerform forward geocoding and return results in Google Geocoding API v3 compatible JSON format.
  • ReadReverse Geocode CoordinatesConvert coordinates to a human-readable address.
  • ReadGeocode XMLGeocode a location query and return results in XML format.
  • ReadCheck API HealthCheck API health and connectivity.

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 LuumenAI has for Opencage is read-only, so it can answer questions from Opencage but cannot change anything in it. Reads are not gated — they answer immediately, and each one is recorded on the audit trail with the actor and the result.

Who gets access to the integration?

You decide. Access is granted per agent, skill, and team, and per environment — production is not staging.

Is there an audit trail?

Every call to Opencage is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.

Put Opencage to work with Luumen

Connect in minutes. Every action scoped, approved, and audited from day one.