Provides AI assistants with data on Algeria's wilayas and communes, GPS location lookups, and validation for Algerian administrative formats.
Also known as syscli/algeria-mcp, algeria-mcp, @syscli/algeria-mcp
- Stars
- 2
- Tools
- 6
- Downloads, 30 days
- —
- Latest version
- 0.1.0
- Last commit
- Oct 10, 2026
- License
- MIT
What is Algeria MCP?
Algeria provides AI assistants with data on Algeria's wilayas and communes, GPS location lookups, and validation for Algerian administrative formats. It exposes 6 tools, such as search_communes, get_wilaya, get_commune.
Summary generated from the project's README
About Algeria MCP server
Providing AI assistants with precise administrative data for Algeria is what this MCP server enables. It allows users to query information regarding the 69 wilayas and 1541 communes sourced from the Journal officiel. Developers can integrate this into Claude Desktop, Cursor, or Claude Code using npx to run the server locally via stdio. Because all data is included within the package, the server makes no network calls during operation.
Users can perform complex administrative lookups using tools like search_communes, which handles French or Arabic names and typos, or locate_point to identify a commune from GPS coordinates. The server also includes a validate tool to verify Algerian formats such as phone numbers, RIP keys, CCP, NIN, NIF, and postal codes. It specifically tracks administrative shifts through the wilaya_changes tool, covering the 2019 and 2026 reforms. This setup requires Node.js 18 or later to function.
What you can do with it
- 1Verify Algerian administrative formatsCheck if a specific RIP or phone number follows the correct national formatting rules.
- 2Track administrative boundary changesIdentify which communes were reassigned to different wilayas during recent government reforms.
- 3Convert GPS coordinates to locationsDetermine the specific commune and wilaya associated with a set of latitude and longitude coordinates.
- 4Search for communes by nameFind specific communes using various spellings, transliterations, or even if the name contains typos.
Written from the project's README. Every use case is checked against a quote from it.
How to install Algeria MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Algeria MCP in Claude Code
$ claude mcp add algeria-mcp -- npx -y @syscli/algeria-mcpInstall Algeria MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"algeria-mcp": {
"command": "npx",
"args": [
"-y",
"@syscli/algeria-mcp"
]
}
}
}Install Algeria MCP in VS Code
.vscode/mcp.json
{
"servers": {
"algeria-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@syscli/algeria-mcp"
]
}
}
}Install Algeria MCP in VS Code CLI
$ code --add-mcp '{"name":"algeria-mcp","type":"stdio","command":"npx","args":["-y","@syscli/algeria-mcp"]}'Install Algeria MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"algeria-mcp": {
"command": "npx",
"args": [
"-y",
"@syscli/algeria-mcp"
]
}
}
}Install Algeria MCP in Codex
$ codex mcp add algeria-mcp -- npx -y @syscli/algeria-mcpInstall Algeria MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.algeria-mcp] command = "npx" args = ["-y", "@syscli/algeria-mcp"]
Install Algeria MCP in Gemini CLI
$ gemini mcp add -s user algeria-mcp npx -- -y @syscli/algeria-mcpInstall Algeria MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"algeria-mcp": {
"command": "npx",
"args": [
"-y",
"@syscli/algeria-mcp"
]
}
}
}Algeria MCP tools 6
Detected from the READMEsearch_communesget_wilayaget_communewilaya_changeslocate_pointvalidate
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablesyscli/algeria-mcp is public and reachablegithub.com/syscli/algeria-mcp ↗Pass
- Package names this repository as its source@syscli/algeria-mcp names syscli/algeria-mcp as sourcenpmjs.com/package/@syscli/algeria-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-10github.com/syscli/algeria-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @syscli/algeria-mcpPass
- No critical advisory in the package or its dependencies101 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubalgeria-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
Algeria MCP questions
How do I add Algeria MCP to Claude Code?
Run claude mcp add algeria-mcp -- npx -y @syscli/algeria-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Algeria MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Algeria MCP provide?
It exposes 6 tools, including search_communes, get_wilaya, get_commune, wilaya_changes, locate_point.
Does this server require an internet connection to access data?
No, the server runs locally and makes no network calls because all data is included in the package.
What kind of formats can be validated?
You can validate phone numbers, RIB, RIP, CCP, license plates, postal codes, NIN, NIF, NIS, RC, wilayas, and communes.
Can I find a commune using GPS coordinates?
Yes, the locate_point tool identifies the commune and wilaya for a given GPS point.