Skip to content
MCP server

Geocode AI

Get the polygon for any country, city or postcode, or describe an area in plain words

Install
Pricing
Freemium
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
1.0.2
Listing updated
2 days ago

About Geocode AI

Geocode AI is a freemium MCP server for maps and travel. It can run locally on your machine or as a hosted remote server.

Geocode AI has two products under one key. Boundaries returns administrative polygons by name or by point, with parents, children, point-in-polygon checks and merging. Areas takes free text, even a clause from a contract, and returns one validated polygon or a refusal with reasons; it handles lists of counties, carve-outs, historic boundaries and non-English text.

Its rule is accept or reject, never guess: if any place cannot be mapped or the result fails validation, the API returns HTTP 422 explaining why. Search is free and needs no key, a polygon costs 1 unit, and a described area costs 50. Free gives 1,000 units a month, Pro is $29 with 50,000, and Business is $199 with 1,000,000.

The same operations run over REST, remote MCP with OAuth, a CLI that doubles as a stdio MCP server, and Claude and Codex plugins.

Install

Run in a terminal

claude mcp add --transport http geocode https://geocodeai.dev/mcp

Add to Settings → Connectors → Add custom connector

https://geocodeai.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "geocode": {
      "url": "https://geocodeai.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "geocode": {
      "type": "http",
      "url": "https://geocodeai.dev/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "geocode": {
      "serverUrl": "https://geocodeai.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "geocode": {
      "type": "http",
      "url": "https://geocodeai.dev/mcp"
    }
  }
}

Configuration

  • GEOCODE_API_KEYGeocode AI API key (geo_...). Optional: public tools work without one.

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

search_boundaries
Search boundaries by name; free and no key needed.
get_boundary
Fetch a boundary polygon, 1 unit.
export_boundary
Export a boundary file.
reverse_boundaries
Find boundaries at a point.
list_children
List subdivisions of a boundary.
contains_points
Test points against a boundary.
union_boundaries
Merge up to 50 boundaries.
create_area
Create a polygon from a text description, 50 units.

What it does

Boundary lookup
Polygons for countries, states, counties, cities, districts and postcodes.
Plain-language areas
Describe a territory and get one validated polygon.
Reverse lookup
Find the boundaries that contain a point.
Batch containment
Test up to 10,000 points per call.
Accept or refuse
Failures return 422 with reasons rather than a guess.
Merge boundaries
Union up to 50 boundaries into one shape.

Good for

  • Define delivery or service zones
  • Route tax rules by jurisdiction
  • Turn a tariff clause into a queryable zone
  • Build sales territories
  • Check which stores fall inside a district

Pricing

Freemium, from $29 a month

Free 1,000 units/month; Pro $29; Business $199

Prices change. Check geocodeai.dev before you buy.

Geocode AI FAQ

Is search free?

Yes, search needs no key and costs nothing.

What does a polygon cost?

1 unit; a described area costs 50 units.

What plans exist?

Free (1,000 units), Pro $29, Business $199, and custom Enterprise.

What if a description cannot be mapped?

You get an HTTP 422 explaining what failed instead of a polygon.

Is Geocode AI free?

Geocode AI has a free plan, with paid plans for more usage or features. Paid plans start at $29 a month.

How do I add Geocode AI to Claude Code?

Run this command in your terminal: claude mcp add --transport http geocode https://geocodeai.dev/mcp

What are the best alternatives to Geocode AI?

The closest alternatives to Geocode AI are Tutu eSIM, Shanghai Streets Travel Guide, Fifty Asks, Gangway AIS and Tickets: tours and event tickets in South America.

Alternatives to Geocode AI

  1. Tutu eSIM

    MCP server

    Live travel eSIM plans, prices and roaming costs for 190+ countries

    • 5 tools
    • Remote
    • Paid
    • Maps and travel
  2. Curated places, walking routes and areas in Shanghai, Jiangsu and Zhejiang

    • 9 tools
    • Remote
    • Free
    • Maps and travel
  3. Fifty Asks

    MCP server

    Let an agent book a free AI-visibility check or a 15-minute call for a local business

    • 10 tools
    • Remote
    • Free
    • Maps and travel
  4. Gangway AIS

    MCP server

    Vessel positions, port calls and anchorage waiting times from licensed AIS data

    • 21 tools
    • Remote
    • Freemium
    • Freight and logistics
  5. Goyondo

    MCP server

    Agent-native trip planner where your AI builds the itinerary and Goyondo stores it

    • Remote
    • Freemium
    • Maps and travel