Sudan Atlas

● Active

io.github.aminshennan/sudan-atlas

Match Sudanese place names (Arabic or English) to official P-codes; get places and boundaries.

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "sudan-atlas": {
      "url": "https://atlas-sudan.vercel.app/api/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http sudan-atlas https://atlas-sudan.vercel.app/api/mcp
VS Code
code --add-mcp '{"name":"sudan-atlas","type":"http","url":"https://atlas-sudan.vercel.app/api/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Maps, Travel & Weather
Version
0.1.4
Registry
active
Published
11/20/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks healthy: Sudan Atlas is maintained, open source, hosted endpoint answering without a key.

Maintained
Active
Last commit 2 days ago (Nov 20, 2026), 0 open issues.
Official registry
Active
Published as io.github.aminshennan/sudan-atlas in the official MCP registry, version 0.1.4.
Source
Open source, MIT
Public repository under the MIT licence, 0 stars, 0 forks.
Runs
Hosted by the publisher
Your client talks to atlas-sudan.vercel.app: prompts and tool arguments leave your machine for that host.
Credentials
None needed to connect
The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 07:08 UTCStatus history & uptime →
● Working141 msprotocol 2025-06-18v0.1.4tools

The endpoint answered the MCP handshake as "sudan-atlas" and listed 6 tools. Answering since Nov 21, 2026.

Context cost ≈ 893 tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 6 tools.

Tools (6)

  • match_place_name3 params

    Match one state or locality name, in Arabic or English and any spelling, to its official P-code. Returns pcode (null when not confident), names, score 0-1, method (exact, variant, fuzzy, ambiguous, none) and up to three alternatives.

    Show parameters
    • namestringrequiredThe place name as written, e.g. 'Elfasher' or 'الفاشر'
    • state_hintstringThe state, as a name in any spelling or a P-code such as SD02
    • level1 for states, 2 for localities; leave out if unknown
  • match_place_names2 params

    Match up to 1,000 names at once (for example a spreadsheet column). Each item can carry its own state hint. Results are in the same order as the input.

    Show parameters
    • namesarrayrequired
    • level1 for states, 2 for localities; leave out if unknown
  • Find states and localities whose official English or Arabic name contains the text, best first, with the matcher's answer for misspellings.

    Show parameters
    • querystringrequired
    • limitinteger
  • get_place1 param

    Official names, level, parent state, localities (for a state), area in km² and estimated population (COD-PS 2025, mid-2025) for a P-code.

    Show parameters
    • pcodestringrequiredA P-code such as SD02 or SD02114
  • list_places2 params

    All 19 admin-1 units (18 states and the Abyei PCA area), or the localities of the whole country or of one state.

    Show parameters
    • levelrequired
    • state_pcodestring
  • get_boundary2 params

    The boundary as a GeoJSON Feature (EPSG:4326) with the place's properties. 'light' is small and enough for most maps; 'medium' is more detailed.

    Show parameters
    • pcodestringrequired
    • resolutionstring

Checked by Serverdex with a plain initialize + tools/list call to atlas-sudan.vercel.app/api/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 21, 2026
Stars
0
Forks
0
Last push
Nov 20, 2026
License
MIT

Pythonadministrative-boundariesarabiccod-abd3gazetteergeocodinggeojsongishumanitarianmapsmcpochaopen-datap-codeplace-namespythonrtlsudantopojsontypescript

From the README

Sudan Atlas toolkit An open toolkit that turns messy Sudanese place names into official codes, and gives the names (Arabic and English) and boundaries of Sudan's 18 states, the Abyei PCA area and 189 localities. It contains: • Python and JavaScript packages (sudan-atlas on PyPI and npm) with the same matcher, data and results; • the data: boundaries following OCHA's COD-AB for Sudan (v03), a gazetteer of reviewed spellings, and the pipeline that builds them; • a skill for AI assistants, and a Claude Code plugin that adds it together with the Sudan Atlas MCP server; • an evaluation of the matcher on real humanitarian data. Status: packages 0.1.4 on npm and PyPI; data release 2026.1 (COD-AB Sudan v03). Use it online: the website atlas-sudan.vercel.app is built on this toolkit: a map of every state and locality, a map-maker that turns a spreadsheet of place names into a map (in the browser; files never leave your device), and the documentation. Quick start JavaScript (npm install sudan-atlas) Python (pip install sudan-atlas, or "sudan-atlas[geo]" for GeoDataFrames) In a browser with no build step: import { match } from "https://cdn.jsdelivr.net/npm/sudan-atlas@0.1/dist/index.js"; the data files are on jsDelivr too, under …/sudan-atlas@0.1/data/. AI assistants: in Claude Code, add the plugin, which brings the skill and the MCP server:…

Read the full README on GitHub →

Remotes

  • streamable-httphttps://atlas-sudan.vercel.app/api/mcp

The most-starred Maps, Travel & Weather servers in the index, with their live-check result.

ServerStarsLast pushLive check
LetsFG — Flights & Hotels2,295Nov 2026Needs sign-in
Hex Research597Nov 2026Local / not checked
Google Maps MCP Server499Oct 2026Local / not checked
UI Craft465Nov 2026Local / not checked
mapbox MCP Server372Nov 2026Needs sign-in

Sudan Atlas: questions people ask

Is Sudan Atlas a remote or a local MCP server?
According to its entry in the official MCP registry, Sudan Atlas ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does Sudan Atlas need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
Is Sudan Atlas safe to use?
Looks healthy: Sudan Atlas is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Sudan Atlas still maintained?
Active: the repository's last commit 2 days ago. Last push Nov 20, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 21, 2026.
What tools does Sudan Atlas expose?
6 tools as listed by the server itself during the live check, including match_place_name, match_place_names, search_places, get_place, list_places. The full list with parameters is in the Live check section above.
How do I add Sudan Atlas to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Maps, Travel & Weather →

Add the badge to your site

Show visitors that Sudan Atlas is listed here — it’s also the link we check for a free listing.

Sudan Atlas — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-aminshennan-sudan-atlas?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Sudan Atlas — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Sudan Atlas — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-aminshennan-sudan-atlas?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-aminshennan-sudan-atlas) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-aminshennan-sudan-atlas) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-aminshennan-sudan-atlas)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-aminshennan-sudan-atlas"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-aminshennan-sudan-atlas"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-aminshennan-sudan-atlas"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).