Connect Opencage to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the reverse geocode tool in Opencage
Use the forward geocode tool in Opencage
Use the batch geocode tool in Opencage
Supported Tools
reverse_geocode
Reverse Geocode
Convert geographic coordinates (latitude/longitude) into a human-readable address and place name.
Returns the formatted address, address components, confidence score, and optional annotations (timezone, currency, sun times, road info, etc.).
Coordinates must use WGS 84 (EPSG:4326) in decimal format.
forward_geocode
Forward Geocode
Convert an address, place name, or location query into geographic coordinates (latitude/longitude).
Results include the formatted address, coordinates, confidence score, address components, and optional annotations (timezone, currency, sun times, road info, etc.).
Use **countrycode** or **bounds** to narrow results to a specific region. Use **proximity** to bias results toward a location.
batch_geocode
Batch Geocode
Geocode up to ten addresses or place names in one tool call, preserving the order and query for each result. Each location uses a separate OpenCage API request.
Enable Opencage in Metorial. In your Metorial portal, enable the Opencage MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Opencage tools.
Enable Opencage in Metorial. In your Metorial portal, enable the Opencage MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Opencage tools.
Enable Opencage in Metorial. In your Metorial portal, enable the Opencage MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Opencage tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Opencage in Metorial. In your Metorial portal, enable the Opencage MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Opencage tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Opencage in Metorial. In your Metorial portal, enable the Opencage MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Opencage tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Opencage through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Opencage and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Opencage tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Convert addresses and place names to coordinates, or coordinates to addresses, using OpenCage's worldwide geocoding API. Narrow forward results by country, bounding box, or proximity, and retrieve location annotations such as timezone, currency, road information, and alternative coordinate formats. Batch geocode up to ten location queries with one API request per query. Structured results include subdivision codes and, for reverse queries, distance from the requested coordinates when available.
Frequently asked questions
Common questions about connecting Opencage to AI agents with Metorial.
How many tools does the Opencage MCP server have?
The Opencage MCP server exposes 3 tools, including Reverse Geocode, Forward Geocode, Batch Geocode. Each one is governed and traced through Metorial.
Does the Opencage MCP server support triggers?
Opencage exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Opencage MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Opencage MCP server through the same Metorial URL.
How do I give only some teams access to Opencage?
Use role-based access control to decide which teams, users, and agents can use Opencage and which of its tools they can call.
Can I self-host the Opencage MCP server?
Yes. Metorial is open source, so you can run the Opencage MCP server yourself or use the hosted gateway.
Connect Opencage to production AI agents
See how Metorial gives your team governed access to Opencage, with tracing and security controls built in.