Can Lyro check that OpenCage is reachable before it runs a lookup?

Yes. Check API Health pings the API and returns 'pong' when it is operational, so a connectivity problem is reported as exactly that rather than surfacing as a geocode that came back empty.

Which output format should we ask OpenCage for?

GeoJSON when the coordinates go straight into a mapping library, XML when an older system parses XML, and JSONP when a browser has to call across domains. Geocode Google v3 JSON exists for legacy integrations only - OpenCage flags it as a format that may be discontinued and recommends the standard JSON output instead.

Can Lyro geocode a whole list of addresses at once?

There is no bulk endpoint in this toolkit. Forward Geocode Address runs once per address, which suits the handful of addresses that come up in a conversation but not importing a spreadsheet of them.

Whose OpenCage quota do these lookups consume?

Your own. The integration authenticates with the API key from your OpenCage account, so every forward and reverse geocode counts against that account's plan. Nothing in the toolkit writes back - all seven actions read geocoding results or the API's health.

Opencage MCP integration

Resolves a typed address into coordinates, names the place behind a coordinate pair, and returns either as GeoJSON, XML, or JSONP.

Connect Opencage See all integrations

7actions available

Three actions you can hand over today

Every action runs live through MCP. Nothing to build, nothing to maintain.

Forward geocode address
Lyro converts a street address into geographic coordinates so you can map customer locations or plan routes. This bridges text data to geographic analysis.
Geocode to geojson
Lyro geocodes addresses and returns GeoJSON format so you can plot locations on interactive maps. This enables geographic visualizations and spatial queries.
Reverse geocode coordinates
Lyro converts GPS coordinates into a readable address to identify a customer's location or service area. This translates lat/long back into names.

See all 7 actions

How businesses use Opencage + Lyro

Each card is one request a support team gets, and the Opencage actions Lyro runs to close it.

Turn the address a customer typed into coordinates
Lyro passes a free-text address to OpenCage and returns latitude and longitude, or the same result as a GeoJSON feature that a mapping library can draw without anyone reformatting the input first.
Forward Geocode AddressGeocode to GeoJSON
Name the place behind a pair of coordinates
Given a latitude and longitude from a device, a form, or a tracking payload, Lyro returns the formatted address, and can run the same lookup as XML when the consuming system parses XML.
Reverse Geocode CoordinatesGeocode XML
Return the result in the format the receiving system expects
For a browser calling across domains Lyro can wrap the result in a JavaScript callback, or emit the legacy Google Geocoding v3 shape so an older integration keeps parsing it unchanged.
Geocode with JSONPGeocode Google v3 JSON

How it works

Get started in 3 steps

Connect once, then just ask. There is no workflow builder to learn and nothing to maintain — Lyro reads the Opencage actions it has and picks the ones a request needs.

01
Connect Opencage
Authorize the Opencage account your team already uses — one consent screen, no API keys, no mapping tables. Lyro can only do what you granted that account, and you can disconnect it at any time.
02
Tell your agent what you need
Describe the job the way you would hand it to a teammate. Lyro maps it to the Opencage actions that close it and chains as many as the request needs.
03
Watch it work
The agent runs the actions inside the conversation the customer is already in, so nobody copies data between tabs and your team can take over at any point.
Get started free

Opencage · Lyro

Everything else about Opencage

Setup, permissions, and the limits of what Lyro can do inside Opencage.

Yes. Check API Health pings the API and returns 'pong' when it is operational, so a connectivity problem is reported as exactly that rather than surfacing as a geocode that came back empty.

Every action available in Opencage

All 7 actions your agent can call on Opencage, straight from the live MCP connection.

Forward geocode address
Convert a human-readable address into geographic coordinates.
Geocode to geojson
Geocode addresses or coordinates and return results in GeoJSON FeatureCollection format.
Geocode with jsonp
Geocode an address and return results wrapped in a JavaScript callback function (JSONP format).
Geocode google v3 JSON
Perform forward geocoding and return results in Google Geocoding API v3 compatible JSON format.
Reverse geocode coordinates
Convert coordinates to a human-readable address.
Geocode XML
Geocode a location query and return results in XML format.
Check API health
Check API health and connectivity.