Geoapify MCP Server

Connect AI assistants and agents to geocoding, place search, routing, and route matrices

Geoapify MCP Server is a remote Maps MCP server that lets AI assistants call Geoapify tools for geocoding, place search, routing, and route matrices. 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 tools can look up addresses, discover nearby places, calculate routes, and compare travel times and distances between locations.

• For AI tools: connect through MCP-compatible clients.
• For location workflows: use MCP tools for addresses, places, routes, travel times, and distances.
• For teams: keep access controlled through your Geoapify API key.

Available MCP Tools

Geoapify MCP Server exposes Geoapify location APIs as MCP tools that AI assistants can call when they need real address, place, or travel data. The seven available tools cover geocoding, category-based place search, route calculation, and travel time and distance matrices. Each tool returns structured results from Geoapify APIs, so AI agents can use the output in follow-up reasoning, search, planning, or data enrichment tasks.

Not sure which integration approach fits your application? Read MCP vs. REST APIs for AI applications to compare model-driven tools with direct API calls.

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 ask about an address, nearby places, a route, or travel times and distances between locations.

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."

Discover Place Categories

Tool: list_place_categories

Example prompts:

• "List the place categories I can use to search for restaurants."
• "Which Geoapify place categories are available for healthcare facilities?"
• "Show me the supported categories for public transport places."

Search for Places

Tool: search_places

Example prompts:

• "Find cafés within 1 km of latitude 48.8584 and longitude 2.2945."
• "Find the 10 nearest pharmacies to coordinates 40.7484, -73.9857."
• "Search for tourist attractions near latitude 51.5007 and longitude -0.1246."

The assistant can call list_place_categories first when it needs to identify the correct category value for search_places.

Calculate a Route

Tool: calculate_route

Example prompts:

• "Calculate a driving route from 48.8584, 2.2945 to 48.8606, 2.3376."
• "Plan a bicycle route between these coordinates and return turn-by-turn instructions."
• "Find a truck route through these three waypoints that avoids tolls."

Calculate a Route Matrix

Tool: calculate_route_matrix

Example prompts:

• "Calculate driving times and distances from these two warehouses to these three delivery locations."
• "Build a walking time matrix for these four coordinates."
• "Compare travel times between all of these locations by bicycle."

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.
• Place search, route calculation, and route matrix tools use the Places API, Routing API, and Route Matrix API, respectively.
• The list_place_categories tool requires an API key but costs zero credits.
• 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