Geocode AI
Get the polygon for any country, city or postcode, or describe an area in plain words
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://geocodeai.dev/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"geocode": {
"url": "https://geocodeai.dev/mcp"
}
}
}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

Tutu eSIM
MCP serverLive travel eSIM plans, prices and roaming costs for 190+ countries
- 5 tools
- Remote
- Paid
- Maps and travel

Shanghai Streets Travel Guide
MCP serverCurated places, walking routes and areas in Shanghai, Jiangsu and Zhejiang
- 9 tools
- Remote
- Free
- Maps and travel
Fifty Asks
MCP serverLet an agent book a free AI-visibility check or a 15-minute call for a local business
- 10 tools
- Remote
- Free
- Maps and travel

Gangway AIS
MCP serverVessel positions, port calls and anchorage waiting times from licensed AIS data
- 21 tools
- Remote
- Freemium
- Freight and logistics
Public tour and ticket search for Gramado, Calafate, Bariloche, Ushuaia and Cartagena
- 3 tools
- Remote
- Free
- Maps and travel

Goyondo
MCP serverAgent-native trip planner where your AI builds the itinerary and Goyondo stores it
- Remote
- Freemium
- Maps and travel