
Opencages
MCP server for forward and reverse geocoding via OpenCage, routed through the Pipeworx
- Pricing
- Freemium
- Platforms
- API, CLI, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Opencages
Opencages is a freemium MCP server for maps and travel. It can run locally on your machine or as a hosted remote server.
The README describes this as an OpenCage geocoding bridge that turns place names into latitude and longitude and coordinates back into formatted addresses. Forward lookups accept country-code filters, bounding boxes and language options, while reverse lookups return the formatted address along with country, city, postcode and timezone details according to the product page.
Connections go through the Pipeworx gateway rather than directly to OpenCage. The README says the endpoint also lists shared gateway meta-tools such as ask_pipeworx alongside the two geocoding tools, and that a local npm stdio bridge is available for MCP clients that need it.
It suits developers and AI agent builders who need location lookups inside an assistant or script. Calls are anonymous and daily-capped by default, and a Pipeworx key raises that cap; the README notes that upstream OpenCage access otherwise requires a key.
Install
Run in a terminal
claude mcp add --transport http opencages https://gateway.pipeworx.io/opencages/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/opencages/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"opencages": {
"url": "https://gateway.pipeworx.io/opencages/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"opencages": {
"type": "http",
"url": "https://gateway.pipeworx.io/opencages/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"opencages": {
"serverUrl": "https://gateway.pipeworx.io/opencages/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"opencages": {
"type": "http",
"url": "https://gateway.pipeworx.io/opencages/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- geocode
- Forward geocode an address or place name to latitude and longitude.
- reverse
- Reverse geocode a latitude and longitude pair to a human-readable address.
What it does
- Forward geocoding
- Converts an address or place name into coordinates with structured address fields.
- Reverse geocoding
- Turns latitude and longitude into a readable address with country, city and postcode.
- Country and bounds filters
- Narrows forward lookups by country code or bounding box.
- Language option
- Lets callers request results in a chosen language.
- Remote and local connection
- Offers a hosted streamable-http endpoint or a local npm stdio bridge.
- Optional API key
- Anonymous calls are capped daily; a free Pipeworx key raises the limit.
Good for
- Converting customer addresses into coordinates inside an AI assistant
- Turning GPS coordinates from logs or devices into readable place names
- Adding country and timezone context to location-based agent workflows
- Validating and normalising address strings before storage
Pricing
Freemium, from $49 a month
Free anonymous tier at 50 calls a day; free account 200 calls a day; paid credits and subscriptions beyond that.
Prices change. Check pipeworx.io before you buy.
Opencages FAQ
Does it need an API key?
The README says the upstream OpenCage access requires a key, and calls without a Pipeworx key are anonymous and capped daily. A free Pipeworx key raises the cap.
Which tools does the server expose?
The README lists geocode for forward lookups and reverse for coordinate lookups, plus shared Pipeworx meta-tools on the gateway endpoint.
Is it an official OpenCage product?
The README states it is an independent, unofficial integration and not affiliated with or endorsed by OpenCage.
Is Opencages free?
Opencages has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.
How do I add Opencages to Claude Code?
Run this command in your terminal: claude mcp add --transport http opencages https://gateway.pipeworx.io/opencages/mcp
What are the best alternatives to Opencages?
The closest alternatives to Opencages are Mapbox, Maptiler, Openrouteservice, Photon and What3words.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.