OpenCage Connector for AI agents.
10 live capabilities
Convert addresses to coordinates and map global locations with precision.
Waiting for input…
Why people use OpenCage
OpenCage Geocoding for Precise Logistics and Data Enrichment
This Connector fixes that by letting your agent do the heavy lifting. You just tell your agent which addresses to check, and it returns the coordinates, timezones, and country data in one go. You get a clean, validated dataset ready for your app or your team.
What Vinkius changes
That you get accurate, filterable location data through a simple chat interface.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Validating a fleet's delivery points
A fleet manager asks the agent to check if 500 new delivery addresses are valid and geocode them for a specific zip code.
- Real-world use case 02
Enriching a global landmark dataset
A researcher asks the agent to find the coordinates and timezones for a list of 1,000 global landmarks in a CSV.
- Real-world use case 03
Finding nearby spots in a city
A developer wants to see what's near a set of coordinates while staying strictly within a specific city boundary.
Complete set · 10capabilities
The complete OpenCage capability set.
These are the exact actions your AI can choose when you ask it to work with OpenCage.
01—04
4 capabilities in this set.
Part of 10 available through OpenCage.
- 01 Capability
Geocode bounding box
Inspects internal arrays to limit results to a specific geographic rectangle. It helps narrow down search areas.
- 02 Capability
Geocode high confidence
Runs automated checks to ensure results meet your minimum confidence score. It keeps your data accurate.
- 03 Capability
Geocode country filter
Extracts properties to ensure results only show for specific country nodes. This prevents matching the wrong city.
- 04 Capability
Geocode language bias
Retrieves location data in specific locales like French or Brazilian Portuguese. It helps with localized data.
05—07
3 capabilities in this set.
Part of 10 available through OpenCage.
- 05 Capability
Geocode all duplicate results
Finds exact structural matches to verify different delivery alternatives. This is great for data validation.
- 06 Capability
Geocode no record privacy
Generates secure mappings without logging the query data. Use this for sensitive user information.
- 07 Capability
Reverse basic
Lists structured rules to export active GPS pins into readable addresses. It turns numbers into names.
08—10
3 capabilities in this set.
Part of 10 available through OpenCage.
- 08 Capability
Reverse fetch time annotations
Extracts UTC logic from location data without keeping validation limits. This is useful for keeping your data clean.
- 09 Capability
Reverse fast no annotations
Identifies location arrays faster by removing unnecessary metadata. It's the best choice for high-speed lookups.
- 10 Capability
Geocode basic
Identifies bounded routing spaces within the OpenCage engine. Use this for standard address to coordinate lookups.
Set up in minutes
One URL. Then ask OpenCage to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use OpenCage 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_WKDzyl3VZM3raWteXPmOlZb4ewVy4fXLQllarGvU/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, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable OpenCage for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_WKDzyl3VZM3raWteXPmOlZb4ewVy4fXLQllarGvU/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 URL.
- Step 03
Save and start
Save the connection and enable OpenCage in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"opencage": {
"url": "https://edge.vinkius.com/vk_preview_WKDzyl3VZM3raWteXPmOlZb4ewVy4fXLQllarGvU/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
Open Agent mode in chat and ask: "Using OpenCage, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"opencage": {
"url": "https://edge.vinkius.com/vk_preview_WKDzyl3VZM3raWteXPmOlZb4ewVy4fXLQllarGvU/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
Ask Copilot: "Using OpenCage, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"opencage": {
"url": "https://edge.vinkius.com/vk_preview_WKDzyl3VZM3raWteXPmOlZb4ewVy4fXLQllarGvU/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
Open Cascade and ask: "Using OpenCage, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"opencage": {
"url": "https://edge.vinkius.com/vk_preview_WKDzyl3VZM3raWteXPmOlZb4ewVy4fXLQllarGvU/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
Ask Cline: "Using OpenCage, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add opencage --transport http "https://edge.vinkius.com/vk_preview_WKDzyl3VZM3raWteXPmOlZb4ewVy4fXLQllarGvU/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
Ask Claude: "Using OpenCage, show me...". 10 tools are ready
Where the request belongs
Work OpenCage can move forward.
This is for the data engineer tired of messy CSVs, the logistics lead trying to stop failed deliveries, and the developer who needs to map out global locations without the headache of manual entry.
Logistics Coordinator
Validates delivery addresses before assigning drivers to save on fuel and time.
Data Engineer
Enriches massive datasets with coordinates and timezone info for better spatial analysis.
App Developer
Builds privacy-first location features that don't leak user data to third-party logs.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsNominatim
Geocode addresses, reverse geocode coordinates and explore OpenStreetMap data. no API key required.
Geocodio
Empower geocoding via Geocodio. perform batch geocoding and reverse geocoding for US/Canada, and retrieve Census and legislative data directly from any AI agent.
Pelias Geocoder
Map geospatial structures via Pelias APIs. convert coordinates, perform reverse geocoding, autocomplete POIs, and retrieve addresses natively by AI logs.
Smarty
Equip your AI with enterprise-grade location intelligence to validate, autocomplete, and extract US or International addresses instantly.
Open-Meteo Geocoding & Elevation
Resolve any city, village, or address into GPS coordinates instantly: multilingual search, population data, timezones, and terrain elevation at 90m precision. the perfect companion for all weather capabilities.
Geocode.xyz
Convert addresses to coordinates, perform reverse geocoding, and extract location data from text with Geocode.xyz.
Bring your own AI
Change the model, client or framework. Keep OpenCage 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.
The practical details behind the request, access and result.
Can OpenCage MCP help me validate my shipping addresses?
Yes, it can. You can ask your agent to check if a list of addresses is valid and get back precise coordinates and confidence scores to ensure they are deliverable.
How does OpenCage MCP handle privacy for sensitive data?
It includes a specific privacy mode. This allows your agent to perform geocoding tasks without the service logging your sensitive address data in third-party logs.
Can I get coordinates for addresses in different languages?
Yes, the Connector supports language bias. You can request results in specific locales like French, Portuguese, or Spanish to match your dataset's needs.
How does the confidence score work in OpenCage MCP?
The capability provides a score for every match. You can tell your agent to only show results that meet a certain threshold, like a 7 or 8, to filter out low-quality data.
Can I limit my search to a specific city or area?
Absolutely. You can use bounding box constraints to limit results to a specific geographic rectangle or use country filters to stay within one nation.
Does OpenCage MCP provide timezone information?
Yes, it returns timezone data along with the address and coordinates, making it easy to enrich your location data for global apps.
How accurate is the geocoding. can I use it for delivery routing?
OpenCage returns a confidence score from 1 to 10 for each result. Use the high-confidence filter (min_confidence=8 or higher) to get delivery-grade accuracy. Combined with country filtering, you can eliminate ambiguous matches and get coordinates reliable enough for last-mile dispatch.
What does privacy mode actually do?
When you enable no_record=1, OpenCage processes your query but doesn't log it in their cache or analytics. The result is identical, but the query leaves no trace on their servers. Ideal for geocoding patient addresses, legal documents, or any PII-sensitive data.
Can I geocode in multiple languages. like getting results in Portuguese for a Brazilian address?
Yes. Use the language bias capability with any IETF language code (pt-BR, es-MX, fr-FR, etc.) and OpenCage returns the address components translated to that locale. Perfect for building multilingual apps or standardizing address formats across regions.
One connection away
Give your agent a direct line to OpenCage.
Connect OpenCage once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available