MCP server for OpenCage geocoding API
Valid MCP server (3 strong, 7 medium validity signals). 3 known CVEs in dependencies (0 critical, 3 high severity) Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.
7 files analyzed · 4 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: YOUR_API_KEY
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-opencagedata-opencage-geocoding-mcp": {
"env": {
"YOUR_API_KEY": "your-your-api-key-here"
},
"args": [
"-y",
"@opencage/mcp-opencage-server"
],
"command": "npx"
}
}
}From the project's GitHub README.
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.
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.
Clone the repository. Change into the repository directory
git clone git@github.com:OpenCageData/opencage-geocoding-mcp.git
# or
git clone https://github.com/OpenCageData/opencage-geocoding-mcp.git
cd opencage-geocoding-mcp
npm install
This is enough to get the MCP working with Claude Desktop (see below)
If you want to develop the MCP and plan to query the MCP from the command line you will also need to:
export OPENCAGE_API_KEY="your_opencage_geocoding_api_key_here"
npm run build
Add this configuration to your Claude Desktop config file
On a Mac the config file should be (~/Library/Application Support/Claude/claude_desktop_config.json), but you can also navigate to the file via the menu: Settings > Developer > Edit Config
{
"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"
}
}
}
}
Note: the first time you run a command you will need to give Claude permission

Convert an address or place name to coordinates and information about that location.
Parameters:
query (required): The address or place name to geocodecountrycode (optional): Restrict to country (ISO 3166-1 alpha-2 code)bounds (optional): Bounding box (min_lon,min_lat,max_lon,max_lat)language (optional): Language for results (e.g., 'en', 'de', 'fr')limit (optional): Max results (1-100, default 10)no_annotations (optional): Exclude location annotationsExample prompts
Prompt: "What are the coordinates of Trafalgar Square, London?"
Result: coordinates, timezone, local currency, etc
Prompt: "Where is Les Vans, France? Which Department is it in?"
Result: coordinates, and correct answer that Les Vans is in the Ardèche department
Prompt: "In welchem Bundesland liegt Weimar?"
Result: coordinates, and correct answer that Weimar is in Thüringen
Convert coordinates to an address and information about that location
Parameters:
latitude (required): Latitude coordinate (-90 to 90) in decimal formatlongitude (required): Longitude coordinate (-180 to 180) in decimal formatlanguage (optional): Language for resultsno_annotations (optional): Exclude location annotationsExample prompts
Prompt: "what is the address at 38.8976, -77.0365?"
Result: "1600 Pennsylvania Avenue NW, Washington, DC 20500, United States of America"
Prompt: "Which province are the coordinates 41.38700, 2.16995 in?"
Result: "Coordinates are in Barcelona in the province of Catalonia"
Check your current API usage and rate limits. NOTE: subscription customers do NOT have hard usage limits. See relevant documentation.
Parameters: None
Returns: Information about remaining requests, rate limits, and reset times.
A helpful assistant for geocoding tasks. Provides guidance on using the geocoding tools effectively.
The server includes comprehensive error handling:
OPENCAGE_API_KEY: Your OpenCage geocoding API key (required)OPENCAGE_API_KEY is setget-api-status toolOpenCage homepage - Get your geocoding API key
OpenCage API Documentation - Full OpenCage geocoding API reference
Model Context Protocol - Learn more about MCP
We run a worldwide geocoding API and geosearch service based on open data. Learn more about us.
We also organize Geomob, a series of regular meetups for location based service creators, where we do our best to highlight geoinnovation. If you like geo stuff, you will probably enjoy the Geomob podcast.
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
by mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
by mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.