# Geocode AI

> Geocode AI is a freemium MCP server for maps and travel. Get the polygon for any country, city or postcode, or describe an area in plain words. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $29 a month
- **Platforms:** API, CLI, Web
- **Website:** https://geocodeai.dev
- **MCP Registry name:** dev.geocodeai/geocode
- **Categories:** maps and travel
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://geocodeai.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "geocode": {
      "url": "https://geocodeai.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [Goyondo](https://ai-powered.com/mcp/goyondo-2): Goyondo is a freemium MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Big Data Insights for Regional Inflow in Korea](https://ai-powered.com/mcp/big-data-insights-for-regional-inflow-in-korea): Big Data Insights for Regional Inflow in Korea is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/geocode-ai
