OpenCage Geocoder Connector for AI agents.
2 live capabilities
Map any global address to precise coordinates for your applications.
Waiting for input…
Why people use OpenCage Geocoder
OpenCage Geocoder for Accurate Global Mapping Data
This Connector lets your agent do that work in seconds. Just give it an address, and it returns the exact location data you need without you ever leaving your current workspace.
What Vinkius changes
Your agent gets a reliable way to understand and interact with global geographic data.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Verifying shipping addresses for delivery
A delivery driver enters a vague address.
- Real-world use case 02
Turning GPS points into street names
A real estate app has a list of GPS points.
- Real-world use case 03
Cleaning messy location datasets
A data analyst has a list of 1,000 addresses in different languages.
Complete set · 2capabilities
The complete OpenCage Geocoder capability set.
These are the exact actions your AI can choose when you ask it to work with OpenCage Geocoder.
01—02
2 capabilities in this set.
Part of 2 available through OpenCage Geocoder.
- 01 Capability
Reverse geocode
Takes a set of coordinates and returns a formatted address with location metadata. Use this to turn raw GPS points into readable streets.
- 02 Capability
Forward geocode
Converts a human-readable address or landmark into precise latitude and longitude coordinates. This is useful for mapping out specific points of interest.
Set up in minutes
One URL. Then ask OpenCage Geocoder to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use OpenCage Geocoder from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_Oo9CdLqd7PdzHDJE8MP4UsAbpXEOl2GV84VNK9hD/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it OpenCage Geocoder, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable OpenCage Geocoder for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_Oo9CdLqd7PdzHDJE8MP4UsAbpXEOl2GV84VNK9hD/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the OpenCage Geocoder URL.
- Step 03
Save and start
Save the connection and enable OpenCage Geocoder in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"opencage-geocoder": {
"url": "https://edge.vinkius.com/vk_preview_Oo9CdLqd7PdzHDJE8MP4UsAbpXEOl2GV84VNK9hD/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using OpenCage Geocoder
Open Agent mode in chat and ask: "Using OpenCage Geocoder, help me...". 2 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"opencage-geocoder": {
"url": "https://edge.vinkius.com/vk_preview_Oo9CdLqd7PdzHDJE8MP4UsAbpXEOl2GV84VNK9hD/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using OpenCage Geocoder
Ask Copilot: "Using OpenCage Geocoder, help me...". 2 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"opencage-geocoder": {
"url": "https://edge.vinkius.com/vk_preview_Oo9CdLqd7PdzHDJE8MP4UsAbpXEOl2GV84VNK9hD/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using OpenCage Geocoder
Open Cascade and ask: "Using OpenCage Geocoder, help me...". 2 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"opencage-geocoder": {
"url": "https://edge.vinkius.com/vk_preview_Oo9CdLqd7PdzHDJE8MP4UsAbpXEOl2GV84VNK9hD/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using OpenCage Geocoder
Ask Cline: "Using OpenCage Geocoder, help me...". 2 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add opencage-geocoder --transport http "https://edge.vinkius.com/vk_preview_Oo9CdLqd7PdzHDJE8MP4UsAbpXEOl2GV84VNK9hD/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using OpenCage Geocoder
Ask Claude: "Using OpenCage Geocoder, show me...". 2 tools are ready
Where the request belongs
Work OpenCage Geocoder can move forward.
Logistics managers who need to verify shipping addresses, data analysts cleaning up messy location sets, and developers building map-heavy apps.
Logistics Coordinator
Verifies shipping addresses and gets coordinates for delivery routing on a Tuesday afternoon.
Data Analyst
Cleans large datasets of addresses to ensure they match real-world locations.
App Developer
Builds location-aware features without setting up a backend for geospatial queries.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsGeocode.xyz
Convert addresses to coordinates, perform reverse geocoding, and extract location data from text with Geocode.xyz.
Pelias Geocoder
Map geospatial structures via Pelias APIs. convert coordinates, perform reverse geocoding, autocomplete POIs, and retrieve addresses natively by AI logs.
Nominatim
Geocode addresses, reverse geocode coordinates and explore OpenStreetMap data. no API key required.
LocationIQ
Convert addresses to coordinates, find places nearby, and calculate routes with LocationIQ's geocoding and mapping capabilities.
LocationIQ (Geocoding & Maps)
Build with location data via LocationIQ. geocode addresses, calculate routes, and perform reverse lookups.
Radar
Equip your AI with geolocation capabilities. convert coordinates to addresses, map intellectual territories, calculate routes, and perform IP-based lookups.
Bring your own AI
Change the model, client or framework. Keep OpenCage Geocoder connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about OpenCage Geocoder.
The practical details behind the request, access and result.
Can OpenCage Geocoder handle international addresses?
Yes, it provides global coverage by pulling from multiple sources like OpenStreetMap.
How does OpenCage Geocoder help with logistics?
It allows your agent to convert shipping addresses into coordinates for easier routing.
Can I get results in different languages?
Yes, you can specify the language format to get addresses in the local dialect.
What is the difference between forward and reverse geocoding?
Forward geocoding turns an address into coordinates, while reverse geocoding turns coordinates into an address.
Can OpenCage Geocoder find nearby roads?
It can retrieve specific road data and attributes to help with more precise location matching.
Is OpenCage Geocoder good for cleaning data?
It's perfect for data analysts who need to standardize a list of messy addresses into clean geographic data.
Can I limit the search results to a specific country?
Yes! Use the countrycode parameter in the forward_geocode capability with ISO 3166-1 alpha-2 codes (e.g., 'us' for USA, 'br' for Brazil) to restrict results to that territory.
How do I get the address of a specific set of coordinates?
Use the reverse_geocode capability by providing the lat (latitude) and lng (longitude). The agent will return the most accurate formatted address found for those coordinates.
Can I get information about the nearest road to a location?
Yes. By setting the roadinfo parameter to true in either forward_geocode or reverse_geocode, the API will attempt to match the location to the nearest road and include road-specific data in the response.
One connection away
Give your agent a direct line to OpenCage Geocoder.
Connect OpenCage Geocoder once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available