# AtlasFetch

AtlasFetch gives AI assistants location lookups, South African address geocoding, street matching, and routes that can account for your own geographic zones.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: atlasfetch-dev
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/atlasfetch-dev/atlasfetch-mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/atlasfetch

## What it does

AtlasFetch exposes location tools through MCP. `lookup_location` maps coordinates to a country, region, municipality, and ISO codes; an optional `street` layer finds nearby streets worldwide. `geocode_address` turns one South African address into a point and reports whether the result reaches a house, corner, named site, street, or locality.

\`get_route` handles 2 to 25 coordinates by car, bike, foot, or truck. Your boundary sets can shape the result: `avoidSets` keeps the route outside named zones, while `exposureSets` measures how much of the route crosses them. Other tools create boundary sets, add GeoJSON polygons, update them, and list their access details.

Address geocoding is limited to South Africa, while place-name search, traffic-aware ETAs, distance matrices, and map tiles are outside its scope. Route times use free-flow speeds, and each route consumes 10 lookups. Node 20 or newer is required for the server to start.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ATLASFETCH_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add atlasfetch -e ATLASFETCH_API_KEY=<ATLASFETCH_API_KEY> -- npx -y atlasfetch-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add atlasfetch --env ATLASFETCH_API_KEY=<ATLASFETCH_API_KEY> -- npx -y atlasfetch-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "atlasfetch": {
            "command": "npx",
            "args": [
                "-y",
                "atlasfetch-mcp"
            ],
            "env": {
                "ATLASFETCH_API_KEY": "<ATLASFETCH_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "atlasfetch": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "atlasfetch-mcp"
            ],
            "env": {
                "ATLASFETCH_API_KEY": "<ATLASFETCH_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ATLASFETCH_API_KEY=<ATLASFETCH_API_KEY> atlasfetch npx -y atlasfetch-mcp
```
Replace <…> with your own values

## When to use it
- map coordinates to administrative areas
- identify the nearest street for a point
- turn a South African address into coordinates
- route around delivery or service zones
- store and revise custom GeoJSON boundaries

## Example prompts
- Tell me the country, region, municipality, and nearest street for `-33.9249, 18.4241`.
- Geocode `25 Adderley Street, Cape Town` and explain the precision of the result.
- Plan a car route through these coordinates while avoiding my `delivery-zones` boundary set.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md