# Opencage — MCP server on mcp.ai
> Connect your Opencage account and use 7 tools for developer tools straight from your AI agent. Connect with your own API key. OpenCage Geocoder provides a simple API for forward and reverse geocoding using open data sources.

By: mcp.ai · official
Page: https://mcp.ai/opencage

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_opencage?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/opencage/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/opencage/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/opencage/skill.md
Postman collection (v2.1): https://mcp.ai/opencage/postman.json

## Tools
- opencage_geocode_forward(q: string, abbrv?: integer, limit?: integer, bounds?: string, pretty?: boolean, language?: string, proximity?: string, add_request?: integer, countrycode?: string, min_confidence?: integer, no_annotations?: boolean) — Tool to convert a human-readable address into geographic coordinates. Use when you need to retrieve latitude and longitude from an address.
- opencage_geocode_geojson(q: string, abbrv?: integer, limit?: integer, bounds?: string, pretty?: boolean, language?: string, roadinfo?: boolean, proximity?: string, add_request?: boolean, countrycode?: string, address_only?: boolean, min_confidence?: integer, no_annotations?: boolean) — Geocode addresses or coordinates and return results in GeoJSON FeatureCollection format. Use this tool when you need: - Geographic data in standard GeoJSON format for mapping applications - Forward ge
- opencage_geocode_geojsonp(q: string, abbrv?: integer, limit?: integer, bounds?: string, pretty?: integer, callback: string, language?: string, no_dedupe?: integer, no_record?: integer, proximity?: string, add_request?: integer, countrycode?: string, min_confidence?: integer, no_annotations?: integer) — Geocode an address and return results wrapped in a JavaScript callback function (JSONP format). Use this tool when you need geocoding results that can be directly consumed by JavaScript through a call
- opencage_geocode_google_v3_json(q: string, abbrv?: integer, limit?: integer, bounds?: string, pretty?: integer, language?: string, roadinfo?: integer, no_dedupe?: integer, no_record?: integer, proximity?: string, add_request?: integer, countrycode?: string, address_only?: integer, no_annotations?: integer) — Tool to perform forward geocoding and return results in Google Geocoding API v3 compatible JSON format. Use when you need Google v3 compatible output for legacy integrations. Note: This is a legacy fo
- opencage_geocode_reverse(q: string, abbrv?: integer, limit?: integer, pretty?: integer, language?: string, roadinfo?: integer, add_request?: integer, countrycode?: string, normalizecity?: integer, min_confidence?: integer, no_annotations?: integer) — Tool to convert coordinates to a human-readable address. Use when you have latitude and longitude and need a readable location.
- opencage_geocode_xml(q: string, abbrv?: integer, limit?: integer, pretty?: integer, language?: string, roadinfo?: integer, no_dedupe?: integer, add_request?: integer, countrycode?: string, min_confidence?: integer, no_annotations?: integer) — Geocode a location query and return results in XML format. Supports both forward geocoding (address to coordinates) and reverse geocoding (coordinates to address). Use this when you need XML-formatted
- opencage_ping_opencage() — Tool to check API health and connectivity. Returns 'pong' if the API is reachable. Use when you need to verify that the OpenCage API is accessible and operational.

## Example prompts
- "What can I do in Opencage?"
- "Show me a summary of my Opencage account"

## Links
Docs: https://mcp.ai/docs/mcps/opencage
Website: https://mcp.ai/mcps/opencage