Skip to content
MCP server

AtlasFetch

Reverse geocoding, South African address lookup and routes that avoid your own zones

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally
Version
0.4.4
Listing updated
3 days ago

About AtlasFetch

AtlasFetch is a freemium MCP server for maps and travel. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

Configuration

  • ATLASFETCH_API_KEYYour API key from https://atlasfetch.xyz/dashboard. Without it, the shared public demo key is used.

Tools this server provides (7)

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

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

What it does

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

Pricing

Freemium, from $9 a month

Free plans; Basic $9/month; Pro $29/month; hard cap, no overage billing

Prices change. Check atlasfetch.xyz before you buy.

AtlasFetch 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 to AtlasFetch

  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