Geoapify MCP Server

Connect AI assistants and agents to geocoding, reverse geocoding, and location lookup

Geoapify MCP Server is a remote Maps MCP server that lets AI assistants call Geoapify geocoding and reverse geocoding tools for addresses and coordinates. It uses the Model Context Protocol or MCP to connect AI tools with real results from Geoapify Maps APIs.

Use it when you want an AI agent to answer location questions with real API results instead of static training data. The current MCP location tools focus on address lookup, structured address geocoding, and coordinate-to-address lookup.

• For AI tools: connect through MCP-compatible clients.
• For maps workflows: use MCP geocoding tools for address and coordinate lookup.
• For teams: keep access controlled through your Geoapify API key.

Available MCP Tools

Geoapify MCP Server exposes Geoapify location APIs as MCP location tools that AI assistants can call when they need real map and address data. The current tool set focuses on geocoding workflows: converting text or structured addresses into coordinates, and converting coordinates back into nearby address data. Each tool returns structured results from Geoapify APIs, so AI agents can use the output in follow-up reasoning, search, or data enrichment tasks.

Getting Started

Connect Geoapify MCP Server to your AI client in two steps:

• Create a Geoapify API key.
• Connect the MCP server to your AI client and start using Geoapify tools.

Authentication

Geoapify MCP Server requires a Geoapify API key to authenticate your MCP client and access Geoapify location APIs.

To create a key:

1. Open MyProjects and sign up or sign in.
2. Create a project.
3. Go to API Keys and copy the generated key.

Check the Geoapify Getting Started guide for more details.

Keep the key private. Add it only in your MCP client settings, and do not include it in prompts, public configuration files, or source code.

Connecting to the MCP Server

Geoapify MCP Server works with MCP-compatible clients that support remote HTTP connections. Choose the setup option that matches your AI assistant or development environment:

Connect via HTTP

Add Geoapify MCP Server as a remote MCP server using your client's HTTP connection settings. The MCP endpoint is:

https://api.geoapify.com/v1/mcp?apiKey=YOUR_API_KEY

Replace YOUR_API_KEY with your Geoapify API key. You can send JSON-RPC requests to this endpoint to list available tools or call a specific tool.

To list the available MCP tools, send a tools/list request:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

To call the geocode_address tool, send a tools/call request with the address and any optional search parameters:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "geocode_address",
    "arguments": {
      "query": "601 Eubank Blvd SE, Albuquerque, NM 87123, United States",
      "country_codes": [
        "us"
      ],
      "limit": 1
    }
  }
}

Add Geoapify MCP Server to ChatGPT

ChatGPT support for custom MCP servers can differ by product version, region, workspace settings, and subscription plan. The option may also appear in the web version before it is available in the desktop app.

The goal is to add Geoapify as a new connector or app. This connector tells ChatGPT where the Geoapify MCP Server is hosted, so ChatGPT can discover and call Geoapify tools during a conversation.

1. Create a new custom MCP connector or app.
2. Use https://api.geoapify.com/v1/mcp?apiKey=YOUR_API_KEY as the server URL.
3. Save the connection.
4. Open a new chat and ask a location-related question to check that Geoapify tools are available.

Add Geoapify MCP Server to Claude

For Claude Code, add Geoapify MCP Server as a remote HTTP server:

claude mcp add --transport http geoapify "https://api.geoapify.com/v1/mcp?apiKey=YOUR_API_KEY"

Then start Claude Code, run /mcp, and check that the geoapify server is connected. Replace YOUR_API_KEY with your Geoapify API key before using the command.

Add Geoapify MCP Server to Cursor

1. Open Cursor Settings.
2. Go to the MCP section.
3. Add a new MCP server named geoapify.
4. Choose the HTTP or remote server connection type.
5. Set the server URL to https://api.geoapify.com/v1/mcp?apiKey=YOUR_API_KEY.
6. Save the configuration and restart Cursor if the server is not loaded automatically.

Connect with other MCP clients

For other MCP-compatible clients, add Geoapify as a remote HTTP MCP server:

1. Create a new MCP server connection.
2. Use https://api.geoapify.com/v1/mcp?apiKey=YOUR_API_KEY as the server URL.
3. Save the connection.
4. Open the client's MCP tools or server status view and confirm that Geoapify tools are available.

Example Prompts + Usage Examples

Start with natural-language prompts. The AI assistant can choose the matching Geoapify MCP tool based on whether you provide an address, structured address fields, or coordinates.

Geocode an Address

Tool: geocode_address

Example prompts:

• "Find coordinates for 1000 5th Avenue, New York, NY."
• "Geocode 350 Fifth Avenue, New York, NY and return the formatted address."
• "Find up to 3 possible matches for 1 Market Street, San Francisco."

Geocode a Structured Address

Tool: geocode_structured_address

Example prompts:

• "Geocode this address: street Market Street, house number 1, city San Francisco, state California, country US."
• "Find coordinates for postcode SW1A 2AA, city London, country GB."
• "Find coordinates for this structured address: house number 10, street Downing Street, city London, postcode SW1A 2AA, country GB."

Reverse Geocode Coordinates

Tool: reverse_geocode_coordinates

Example prompts:

• "What address is located at 48.8584, 2.2945?"
• "Reverse geocode coordinates 40.7484, -73.9857 and return the formatted address."
• "Find the nearest address for latitude 51.5007 and longitude -0.1246."

API Credits and Rate Limits

Geoapify MCP Server calls Geoapify Maps APIs behind the scenes:

• For example, when an AI assistant uses geocode_address, the MCP server sends a request to the Geoapify Geocoding API.
• Usage and cost are calculated only for the underlying Geoapify Maps API requests.
• The MCP server does not add separate charges, extra credits, or additional rate limits.

Frequently Asked Questions