OpenCage Geocoding MCP Server
About
MCP server for querying the OpenCage geocoding API from within LLMs
Details
- License
- MIT
Explore
- Forward Geocoding: Convert addresses or place names to coordinates (latitude/longitude)
- Reverse Geocoding: Convert coordinates to addresses
- API Status Monitoring: Check your API usage and rate limits (assuming your penCage account has hard limits).
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
OpenCage Geocoding MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Node.js (version 20 or higher)
2. OpenCage geocoding API Key: Sign up on the OpenCage website to get a free-trial geocoding API key
- OPENCAGE_API_KEY: Your OpenCage geocoding API key (required)
Note: the first time you run a command you will need to give Claude permission
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"opencage geocoding mcp server": {
"opencage-geocoding": {
"command": "node",
"args": [
"/ABSOLUTE/PATH/TO/opencage-geocoding-mcp/build/index.js"
],
"env": {
"OPENCAGE_API_KEY": "your_opencage_geocoding_api_key_here"
}
}
}
}
}McpServers
{
"opencage-geocoding": {
"command": "node",
"args": [
"/ABSOLUTE/PATH/TO/opencage-geocoding-mcp/build/index.js"
],
"env": {
"OPENCAGE_API_KEY": "your_opencage_geocoding_api_key_here"
}
}
}An MCP (Model Context Protocol) server that provides geocoding capabilities using the OpenCage geocoding API.
This server allows you to convert between addresses and geographic coordinates.
PLEASE NOTE: the examples shown here are based on an integration with claude.ai's desktop client. MCP as a concept is supported by other services, but may require a slightly different configuration.
Features
- Forward Geocoding: Convert addresses or place names to coordinates (latitude/longitude)
- Reverse Geocoding: Convert coordinates to addresses
- API Status Monitoring: Check your API usage and rate limits (assuming your penCage account has hard limits).
Prerequisites
1. Node.js (version 20 or higher)
2. OpenCage geocoding API Key: Sign up on the OpenCage website to get a free-trial geocoding API key
Installation
0. Is MCP the right tool?
This MCP is the right tool for small amounts of geocoding, for example while manually prompting an LLM.
If however, you want to process larger volumes of data, for example CSV files full of address or coordinates, or connecting to database full of data, it is almost certainly both faster and more affordable to use our command line tools, or have the LLM write a script to call our API directly.
We offer a markdown-formatted opencage-geocoding-api SKILL file to train your AI on best practices for working with our geocoding API.
1. Clone the repository. Change into the repository directory
```bash
git clone [email protected]:OpenCageData/opencage-geocoding-mcp.git
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
