# AtlasFetch

> AtlasFetch is a freemium MCP server for maps and travel. Reverse geocoding, South African address lookup and routes that avoid your own zones. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, CLI
- **Website:** https://atlasfetch.xyz
- **Repository:** https://github.com/atlasfetch-dev/atlasfetch-mcp
- **MCP Registry name:** xyz.atlasfetch/atlasfetch
- **Categories:** maps and travel
- **Listing updated:** 2026-11-14

## About

AtlasFetch resolves a coordinate to the country, region and municipality that contain it, with ISO 3166 codes, using a point-in-polygon lookup rather than a model's memory. It can also return the nearest street and house number, an H3 cell or a Plus Code, and match the point against boundary sets you have drawn, such as delivery zones or service areas.

Routing is the distinguishing part: `get_route` takes 2 to 25 coordinates for car, bike, foot or truck, can route around named boundary sets, or leave the route alone and report how many metres of it ran inside each zone. Durations are free-flow, with no traffic, so they are not ETAs. Address geocoding covers South Africa only for now, and the README lists what it is not for, including place-name search, distance matrices and map tiles.

A lookup costs one unit and a route ten. The free plans include 1,000 lookups a month, Basic is $9 and Pro $29, and a spent allowance returns a 402 rather than a bill. Without an API key the server falls back to a shared demo key limited to 1,000 lookups a month across all users.

## Features

- **Reverse geocoding:** Coordinate to country, region and municipality with ISO 3166 codes.
- **Nearest street:** Optionally returns the nearest street and house number.
- **South African addresses:** Geocodes an address to a point with a precision rating.
- **Zone-aware routing:** Routes around your boundary sets or measures distance driven inside them.
- **Custom boundary sets:** Create sets and add or update GeoJSON polygons with properties.
- **Hard usage cap:** Requests past the allowance get a 402 and no extra charge.

## Good for

- Tag location data with region and municipality codes
- Check whether a point lies inside a delivery zone
- Geocode delivery addresses in South Africa
- Plan a truck route that stays out of restricted areas
- Measure how far a route runs through a territory

## Install

### Claude Code (Terminal)

```sh
claude mcp add atlasfetch --env ATLASFETCH_API_KEY='<ATLASFETCH_API_KEY>' -- npx -y atlasfetch-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "atlasfetch": {
      "command": "npx",
      "args": [
        "-y",
        "atlasfetch-mcp"
      ],
      "env": {
        "ATLASFETCH_API_KEY": "<ATLASFETCH_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "atlasfetch": {
      "command": "npx",
      "args": [
        "-y",
        "atlasfetch-mcp"
      ],
      "env": {
        "ATLASFETCH_API_KEY": "<ATLASFETCH_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "atlasfetch": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "atlasfetch-mcp"
      ],
      "env": {
        "ATLASFETCH_API_KEY": "<ATLASFETCH_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "atlasfetch": {
      "command": "npx",
      "args": [
        "-y",
        "atlasfetch-mcp"
      ],
      "env": {
        "ATLASFETCH_API_KEY": "<ATLASFETCH_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "atlasfetch": {
      "command": "npx",
      "args": [
        "-y",
        "atlasfetch-mcp"
      ],
      "env": {
        "ATLASFETCH_API_KEY": "<ATLASFETCH_API_KEY>"
      }
    }
  }
}
```

## Tools

- `lookup_location`: Coordinate to containing country, region and municipality
- `geocode_address`: Address to a point, South Africa
- `get_route`: Route between 2 to 25 coordinates, optionally around or measuring zones
- `list_boundary_sets`: List your boundary sets
- `create_boundary_set`: Create an empty boundary set
- `add_boundary`: Add a GeoJSON polygon
- `update_boundary`: Reshape a boundary

## FAQ

### Do I need a key to try it?

No. Without a key it uses a shared public demo key capped at 1,000 lookups a month for everyone.

### How are routes counted?

A route costs 10 lookups; a lookup costs 1.

### Does it give traffic-aware ETAs?

No. Durations are free-flow with no live or historical traffic.

### Where does address geocoding work?

South Africa only at present.

### Is AtlasFetch free?

AtlasFetch has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add AtlasFetch to Claude Code?

Run this command in your terminal: claude mcp add atlasfetch --env ATLASFETCH_API_KEY='<ATLASFETCH_API_KEY>' -- npx -y atlasfetch-mcp

### What are the best alternatives to AtlasFetch?

The closest alternatives to AtlasFetch 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/atlasfetch
