About Algeria
Algeria is a read-only MCP server for assistants that need information about Algerian wilayas, communes, locations, and common administrative formats. Its bundled data lets it run locally without network calls.
Key features
- 01Search communes by name
- 02Look up wilayas and communes
- 03Find locations from GPS coordinates
- 04Track commune changes across reforms
- 05Validate Algerian administrative formats
Use cases
- 01Identify a commune from a GPS point
- 02Check which wilaya a commune belongs to
- 03Validate a phone number or RIP key
MCP support
It exposes read-only search, lookup, location, reform-history, and validation tools to MCP clients. The server runs locally over stdio and makes no network calls.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
6Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | Maximum results, default 10 |
| query | string | Yes | Commune name, e.g. 'bou saada' or 'Bains Romains' |
| wilaya | string | No | Only search in this wilaya, by code ('16') or name ('Alger') |
Details
From the project READMEalgeria-mcp
An MCP server that lets AI assistants answer questions about Algeria's 69 wilayas and 1541 communes from the Journal officiel, and check Algerian formats such as phone numbers and RIP keys.
Ask your assistant things like:
- Which wilaya is Bou Saada in since 2026?
- Which communes moved to the wilaya of El Kantara?
- Which commune is the point 36.365, 6.6147 in?
- Is the RIP 007 99999 0000000200 91 well formed?
Setup
Also listed in the official MCP Registry as io.github.syscli/algeria-mcp.
Claude Code:
claude mcp add algeria -- npx -y @syscli/algeria-mcp
Claude Desktop, Cursor and other clients, in their MCP configuration file:
{
"mcpServers": {
"algeria": {
"command": "npx",
"args": ["-y", "@syscli/algeria-mcp"]
}
}
}
It runs locally over stdio, needs Node.js 18 or later, and makes no network calls: all the data ships with the package.
Tools
| tool | |
|---|---|
search_communes | find communes by name in French or Arabic, with old names, transliterations and typos |
get_wilaya | a wilaya by code or name, with its communes |
get_commune | a commune by ONS code, with its wilaya under the 69, 58 and 48 maps |
wilaya_changes | communes moved by the 2026 or 2019 reform |
locate_point | the commune and wilaya of a GPS point |
validate | check a phone number, RIB, RIP, CCP, plate, postal code, NIN, NIF, NIS, RC, wilaya or commune |
All tools are read-only.
Data
- Wilayas and communes: @syscli/algeria, from the Journal officiel. MIT.
- Boundaries used by
locate_point: OpenStreetMap via geoBoundaries, CC BY-SA 2.0. (c) OpenStreetMap contributors. - Format rules: @syscli/dz-format, with the source of each rule.
Related projects
| project | what | get it |
|---|---|---|
| algeria | the 69 wilayas and 1541 communes, search, GPS lookups | npm @syscli/algeria, PyPI syscli-algeria, site AlgerieGeo |
| dz-format | checks for phone numbers, RIP and RIB keys, plates, NIF, RC and more | npm @syscli/dz-format, PyPI dz-format, playground |
| algeria-mcp | both of the above for AI assistants | npm @syscli/algeria-mcp, MCP Registry io.github.syscli/algeria-mcp |
Releases and security
Versions are listed in CHANGELOG.md. Releases are published
from GitHub Actions with npm provenance; npm audit signatures checks them.
To report a security problem, see SECURITY.md.
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.