Use the atlas from any AI assistant
The site runs a read-only MCP server. Connect it, and your assistant can look up any wilayat, governorate or national figure here, each with its source attached.
https://wilayat-atlas.pages.dev/mcpLet your agent do it
Paste this into a coding agent such as Codex, Claude Code or Cursor. It adds the server and shows you the change first.
Add one remote MCP server to your configuration.
Name: wilayat
URL: https://wilayat-atlas.pages.dev/mcp
Transport: Streamable HTTP. Read-only, no sign-in, no API key.
Use your own documented way of adding a remote HTTP MCP server. Add only this server. Don't install packages, run scripts, or change or remove any other server. If it's already set up, leave it as it is. Show me the change before you apply it. Then confirm it's registered (for example with your mcp list command), and tell me if I need to restart you before its tools appear: search, get_wilayat, get_governorate, list_wilayats, get_national. If a step needs me to click something in an app, tell me what.In the ChatGPT or Claude chat app? Use the steps below.
Or set it up by hand
ChatGPT
Chat app
On the web. Workspace permissions may apply.
- Open Plugins → + → Add custom MCP server.
- Name it Wilayat, paste the server URL and choose No authentication.
- Accept the warning, create the plugin, then install it.
- In a chat, type @ and pick Wilayat.
Coding agent (Codex)
Terminalcodex mcp add wilayat --url https://wilayat-atlas.pages.dev/mcp
Claude
Chat app, web and desktop
Free plans can add one custom connector.
- Open Customize → Connectors → Add → Custom → Web.
- Name it Wilayat, paste the server URL, then click Continue.
- Review the detected authentication settings and click Continue.
- Under Authentication, choose No sign in, then click Add.
- In a chat, open + → Connectors and turn Wilayat on.
Coding agent (Claude Code)
Terminalclaude mcp add --transport http wilayat https://wilayat-atlas.pages.dev/mcp
Cursor
Editor
Add
wilayatinside themcpServersobject in~/.cursor/mcp.json. Keep your other servers.~/.cursor/mcp.json{ "mcpServers": { "wilayat": { "url": "https://wilayat-atlas.pages.dev/mcp" } } }
Steps last checked November 2026. If a menu has moved, see the app's own docs.
Five tools
Your assistant picks the tool. You ask in plain words, in English or Arabic.
searchWilayats and governorates matching a name, in English or Arabic, misspellings included.“Which governorate is Bidbid in?”get_wilayatOne wilayat: population 2010–2025, age bands, labour rates, schools, neighbours and ranks.“How has Barka's population changed since 2010?”get_governorateOne governorate: its wilayats, population 2010–2025, age bands, labour rates, schools and hospitals.“Which wilayats make up Ad Dakhiliyah?”list_wilayatsRanks wilayats by population, growth, labour rates, schools, age groups and more, across Oman or in one governorate.“Which wilayat has the highest unemployment rate?”get_nationalOman as a whole.“What share of Oman's population is Omani?”Every figure carries its source
Every reply with figures names the datasets and licences behind them. When the source likely got a number wrong, the reply says so, and the number stays as published.
See a sample reply
get_wilayat { "wilayat": "Muscat" }
"data": {
…,
"population": { "year": 2025, "total": 45167, "omani": 21886, "expat": 23281, … },
"series": [ …, { "year": 2023, "total": 69008, … }, … ]
},
"meta": {
…,
"warnings": [{
…, "field": "total.total", "year": 2023, "published_value": 69008,
"note": "2023 figure (69,008) is far from both 2022 (37,865) and 2024 (36,272); it is published as NCSI gave it and is likely a source error."
}],
"sources": [{
"name": "NCSI, Population (OMPOP2016)",
"licence": "Oman Open Data Use Licence (compatible with CC BY 4.0)",
"fields": ["population","series","ages","ages_2015","density"], …
}, …]
}
- sources
- The dataset each figure comes from, so your assistant can cite it.
- licence
- The terms it is published under, so anyone reusing a figure can credit it.
- warnings
- Only on the figures flagged on the Data page. The value is never corrected.