MCP-Dubai
MCP-Dubai is an MCP server connecting AI agents to Dubai & UAE public data and curated business setup knowledge, offering 120 tools across 37 features. Most tools (112/120) require no API keys.
Daily Life & Islamic Tools
Prayer times, Quran text/search, Hijri/Gregorian conversion, Qibla direction
Weather (METAR/TAF & human-friendly forecasts for 8 UAE cities + arbitrary coordinates)
Real-time air quality (AQI, PM2.5, NO2, etc.)
UAE federal public holidays, next holiday lookup
Finance & Markets
CBUAE exchange rates (~75 currencies vs AED), base interest rate, currency conversion
Dubai Financial Market (DFM) index snapshots and ~454 stock quotes
Dubai retail gold rates (24K–14K in AED/gram)
Location & Maps
OpenStreetMap POI search near any Dubai location
Makani geocoding (forward/reverse, validation)
data.dubai catalog search (600+ datasets from 76 entities)
Business Setup & Advisory
Mainland vs. free zone vs. offshore recommendations based on activity, budget, visa needs
Compare 12 major free zones (DMCC, DIFC, JAFZA, IFZA, etc.) with costs, visa quotas, office options
14-bank matrix with onboarding speed, minimum balance, DUL fast-track eligibility, and personalized recommendations
UAE visa types (including Golden Visa, Green Visa, 2026 additions) with eligibility checks
Tax & Compliance
Corporate tax estimation (9% above AED 375,000), QFZP qualifying activity check
VAT filing calendar, ESR status, e-invoicing timeline, late-payment penalties
AML/CFT requirements by category, UBO filing (Cabinet Decision 58/2020)
PDPL compliance (UAE Federal, DIFC, ADGM), Emiratisation targets
Tenancy & Living Costs
Ejari registration guidance, RERA rent increase calculations, Rental Disputes Centre filing
Rent estimates by area/bedrooms, DEWA bill estimates, Salik toll costs, grocery/fuel prices
Government, Legal & Founder Essentials
UAE attestation/legalization chain guidance (UAE is NOT a Hague member)
PRO service and legal translation cost estimates
Government portal guide (MOHRE, ICP, FTA, EmaraTax, GDRFA, etc.)
Business setup timelines, 11 common founder mistakes
IP/trademark registration, halal certification, Dubai Chamber of Commerce info
Education & Sector Knowledge
Dubai private schools search by curriculum, area, KHDA rating, fee ceiling
UAE accelerators/incubators, active MENA VCs, government grants (MBRIF, Khalifa Fund)
Dubai startup/tech events (GITEX, Expand North Star, Dubai AI Festival)
Parkin parking tariffs, Nol card guide, DCDE programs, Dubai Create Apps Championship
Tier 1 (Credentials Required)
Dubai Land Department real estate transactions, RTA metro/bus data, Salik tariffs, RERA broker lookup
Agent & Meta Tools
recommend_tools: BM25-powered natural-language tool discoverylist_features,get_knowledge_status,get_upstream_status,aboutarabic_writer: bilingual Arabic/English business letter templates with correct UAE honorificsdata_analyst: cross-tool planning and structured Markdown report synthesis
Provides tools to search for points of interest (restaurants, pharmacies, mosques, ATMs, metro stations, etc.) near a Dubai location using the OpenStreetMap Overpass API.
Provides tools to fetch Central Bank of UAE exchange rates and base rates via undocumented Umbraco endpoints.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP-DubaiWhat time is Fajr today in Dubai?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP-Dubai
خادم MCP للبيانات العامة في دبي والإمارات وللمعرفة العملية لتأسيس الأعمال An MCP server for Dubai and UAE public data plus curated business setup knowledge
Connect AI agents (Claude, GPT, Cursor, Copilot) to Dubai and UAE public APIs and curated business setup knowledge.
🔧 120 tools · 🏛️ 37 features · 📚 19 freshness-tracked knowledge domains · ✅ 112 credential-free tools · 💼 56 business advisor tools · 🤖 2 agent skills
Quick Start · Tool Catalogue · Knowledge Freshness · Audit 2026-08-14 · Architecture · Roadmap · Contributing
Dubai gave me a life. I promised myself I'd give something back.
by Mahdi Salmanzade, Software Developer, Dubai 📧 mahdi@clrtstudio.com · 📅 April 2026
⚠️ Knowledge Date: not uniform. Check per domain.
Freshness is per domain, not project-wide. As of 14 August 2026:
Latest recorded update
Packs
2026-08-14
banking,cost_of_living,createapps,dcde,founder_essentials,free_zones,funding,ip_trademark,setup_advisor,tax_compliance2026-07-25
compliance,tenancy,visas2026-07-02
events,parkin2026-04-13
arabic_writer,data_analyst,gov_portals,halalThe August audit was targeted, not a claim that every field was re-verified. Every knowledge response distinguishes the latest
knowledge_datefromfull_review_dateand exposeslast_refresh_scopeandprevious_knowledge_datewhere relevant. The checker covers all 19 domains and applies each alerting budget to the last full review, so a targeted update cannot hide stale untouched content.Business rules in the UAE (corporate tax, visas, free zone pricing, accelerator cycles, API migrations) change frequently. Always verify with the official source before making real decisions. Every
biz/*tool returns its latest recorded update and full-review date, andget_knowledge_status()reports the prior date and targeted scope where declared.
📋 Table of Contents
Related MCP server: filed-mcp-server
🌟 What is this?
MCP-Dubai is a Model Context Protocol server that gives AI agents a single, well-typed interface to two distinct kinds of knowledge about Dubai and the UAE:
Public Dubai and UAE government data, like prayer times, exchange rates, school ratings, real estate transactions, transport networks, and more.
Curated business setup knowledge that no other MCP server has, like which free zone to choose for a SaaS startup, which visa to apply for as a freelance developer, how to estimate corporate tax under the QFZP rules, the full Hague-not-an-option attestation chain, 10 common founder mistakes, and a 14-bank matrix with a dated DUL bank-integration snapshot.
Drop it into Claude Desktop, Cursor, VS Code, or any MCP-compatible client and your AI assistant can answer questions like "what time is Fajr tomorrow in Dubai Marina?" or "where should I set up my SaaS company in Dubai with a 25K AED budget?" with structured, freshness-stamped answers and source or verification links where available.
💡 Why MCP-Dubai exists
Dubai's public data lives across at least a dozen platforms (data.dubai and its apis.data.dubai gateway, opendata.fcsc.gov.ae, bayanat.ae, centralbank.ae, aladhan.com, web.khda.gov.ae, aviationweather.gov, and more) each with its own auth, format, and rate limits. Most agencies do not expose self-serve APIs. The few that do are gated behind email-issued OAuth credentials or paywalled at AED 31,500/year per product.
On top of that, founders coming to Dubai face the same questions over and over: which license, which visa, which bank, how much, how long. The web answers are SEO-spam from agency setup firms.
MCP-Dubai is the honest, code-first answer.
Ships 43 Tier 0 tools that require no credentials, backed by anonymous upstreams, bundled snapshots, and local reference data. Authentication status is separate from upstream health: the four FCSC CKAN tools and the CBUAE base-rate endpoint are recorded as blocked, while two WAQI reading tools require a free token.
Layered with 16 curated JSON knowledge packs plus a setup advisor that composes them. Each pack carries freshness metadata and a top-level verification URL; individual records include additional source URLs where available.
Uses the same
KnowledgeMetadataenvelope on every business response so the LLM (and you) can see the latest recorded update, prior date, and targeted scope where declared.Inspired by mcp-brasil. Aligned with Dubai Data Law (Law 26 of 2015). Run as a community contribution.
🚀 Quick Start
Works in any MCP client. No API credentials are needed to invoke 112 of 120 tools in the current source tree. This is an authentication count, not a live-availability guarantee; five of those tools currently report blocked upstreams.
Release status (14 August 2026): this repository is version 0.4.0 with 120 tools, but PyPI still serves version 0.2.0 with 91 tools. The
uvx mcp-dubaiandpip install mcp-dubaiexamples below therefore install the older public release until the maintainers publish 0.4.0. To run the current code, clone this repository and usemake dev && make run.
The recommended published-package runner is uvx (ships with uv); plain pip install mcp-dubai also works.
Claude Code
claude mcp add dubai -- uvx mcp-dubaiOr commit a project-scoped .mcp.json at your repo root so your whole team gets it:
{
"mcpServers": {
"dubai": {
"command": "uvx",
"args": ["mcp-dubai"]
}
}
}Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"dubai": {
"command": "uvx",
"args": ["mcp-dubai"]
}
}
}Claude Desktop with Dubai Pulse credentials (unlocks Tier 1 tools)
Tier 1 (Dubai Pulse OAuth) dld and rta tools ship today and return structured setup instructions until you set these credentials:
{
"mcpServers": {
"dubai": {
"command": "uvx",
"args": ["mcp-dubai"],
"env": {
"MCP_DUBAI_PULSE_CLIENT_ID": "your-client-id",
"MCP_DUBAI_PULSE_CLIENT_SECRET": "your-client-secret",
"MCP_DUBAI_WAQI_TOKEN": "optional-waqi-token"
}
}
}
}Get Dubai Pulse credentials by requesting dataset access at data.dubai. Get a WAQI token (free) at aqicn.org/data-platform/token.
Cursor
Click the install badge above, or add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):
{
"mcpServers": {
"dubai": {
"command": "uvx",
"args": ["mcp-dubai"]
}
}
}VS Code (GitHub Copilot)
Click the install badge above, or run:
code --add-mcp '{"name":"dubai","command":"uvx","args":["mcp-dubai"]}'Or create .vscode/mcp.json in your project root:
{
"servers": {
"dubai": {
"command": "uvx",
"args": ["mcp-dubai"]
}
}
}Windsurf
Add the same mcpServers block as Cursor to ~/.codeium/windsurf/mcp_config.json.
Codex CLI
codex mcp add dubai -- uvx mcp-dubaiGemini CLI
gemini mcp add dubai uvx mcp-dubaiAny other MCP client
The repository includes a validated MCP Registry manifest for io.github.mahdi-salmanzade/mcp-dubai, but no public registry record exists as of 14 August 2026. Until the maintainers complete that publication, use a manual stdio configuration:
{
"command": "uvx",
"args": ["mcp-dubai"]
}🧰 Tool Catalogue
120 tools across 37 features. Of 45 Tier 0 tools, 43 require no credentials; two WAQI reading tools require a free token. Credential requirements do not guarantee upstream availability: the CBUAE base-rate tool and four FCSC tools are currently recorded as blocked. Tier 2 business knowledge and agent-skill tools also ship, while the six Tier 1 live-query tools require data.dubai OAuth. Use recommend_tools(query) to find the right tool for any natural-language question.
✅ Tier 0: public-data tools
Feature | Tools | What it does |
|
| Prayer times for any UAE city or coords, Qibla compass bearing, Hijri/Gregorian conversion. Method 8 (Gulf Region) is the default; method 16 (Dubai experimental) matches Dubai mosque announcements. |
|
| Full Quran text and translations. Multiple editions (Arabic Uthmani, Sahih International English, Urdu, etc.). Search is bounded and paginated: 25 results by default, 100 maximum per call, with |
|
| Central Bank of UAE exchange rates against AED for 76 currencies (today or historical), bilingual rows with ISO 4217 codes. The undocumented exchange-rate endpoint is anonymous; the base-rate endpoint is recorded as Cloudflare-blocked as of 14 August 2026. |
|
| Credential-free wrappers for the UAE federal open-data CKAN interface, including Federal Customs Authority trade search. All four endpoints are recorded as Cloudflare-blocked as of 14 August 2026 and return structured errors. |
|
| Search Dubai private schools by name, area, curriculum, KHDA inspection rating, or fee ceiling. Backed by a curated snapshot of well-known schools; full XLSX refresh script in roadmap. |
|
| METAR (current observation) and TAF (forecast) for the 6 UAE international airports (OMDB Dubai International, OMDW Al Maktoum, OMSJ Sharjah, OMAA Zayed International, OMAL Al Ain, OMRK RAK). The standard substitute for the missing NCM public API. |
|
| Keyless human-friendly weather: current temperature, feels-like, humidity, wind, and a multi-day forecast (highs, lows, rain chance, UV) for 8 UAE cities or any coordinate, via Open-Meteo. The everyday companion to the pilot-oriented |
|
| Keyless everyday currency conversion on an AED base via the ExchangeRate-API open endpoint. The convenient companion to the official |
|
| Real-time air quality (AQI, PM2.5, PM10, NO2, SO2, CO, O3) for Dubai stations via WAQI/AQICN. Requires a free token from |
|
| Find OpenStreetMap POIs near a Dubai location: restaurants, pharmacies, mosques, ATMs, metro stations, malls, parking, etc. 22 curated categories. |
|
| UAE federal public holidays for 2026 (observed dates confirmed through Hijri New Year, including the 15 June transfer) and a provisional 2027 calendar. The Prophet's Birthday religious date is provisionally 25 August 2026, but no official day-off or transfer announcement had been published by 14 August. Lunar holidays stay flagged |
|
| Dubai Financial Market live market data: the DFM General Index snapshot and quotes for 475 records in the 14 August 2026 live check via the anonymous JSON endpoints behind dfm.ae. Undocumented and best-effort; data may be delayed; not investment advice. |
|
| Dubai Municipality's official Makani geo-addressing service: turn coordinates into Makani numbers and building info (EN+AR), look up a 10-digit Makani number, or validate one. Covers all seven emirates. |
|
| Dubai Jewellery Group suggested retail gold rates (24K to 14K, AED per gram) from Dubai City of Gold, published around 09:00, 13:30, and 18:00 UAE time. Jewellery reference rates, not spot bullion. |
|
| Search the data.dubai catalog (614 datasets from 76 Dubai entities in the 14 August 2026 live check), the portal that replaced Dubai Pulse. Credential-free metadata: dataset descriptions, formats, licences, update frequency, and API endpoints. The dataset APIs themselves still need credentials. |
💼 Tier 2: curated business knowledge (no external API, ship today)
Feature | Tools | What it does |
|
| The headline tool. Recommends mainland vs free zone vs offshore for a Dubai business setup. Cross-references curated free zones, visas, banks, and tax rules. For onshore activity, it compares a mainland DET licence with the conditional branch-licence or temporary-permit route available to eligible Dubai free zone establishments under Executive Council Resolution 11 of 2025. Surfaces the SaaS-is-not-QFZP-Qualifying warning automatically. |
|
| All 12 major Dubai free zones (DMCC, DIFC Innovation, JAFZA, DAFZA, IFZA, Meydan, Dubai South, DSO/Dtec, TECOM, DHCC, DPC/DSC, DIFC full FS) with cost, office options, visa quota, and bank acceptance reputation. Plus JAFZA Offshore and RAK ICC, the free-zone-to-mainland permit regime (Executive Council Resolution 11 of 2025), and the 2026 developments block (District IO, Meydan remote setup, DMCC at 26,000+ members). Renewal cost myth is corrected here: it is NOT 20-30% higher than setup. |
|
| UAE visa types including the 2026 additions: the Dubai 2-year property investor visa (AED 750K minimum removed for sole owners), the expanded visa-on-arrival list, and the GDRFA-DLD single-channel process note. Green Visa correctly split into the AED 15K/month skilled employee track and the freelancer track. Golden Visa specialized talent at AED 30,000 basic monthly. Includes a myth-buster on the non-existent AED 100K lifetime Golden Visa. |
|
| 14-bank matrix (Wio, Mashreq NEOBiz, Zand, ruya, Emirates NBD, RAKBANK, ADCB, FAB, CBD, ADIB, HSBC, StanChart, Citi, Liv) on onboarding speed, minimum balance, and crypto stance. Plus a dated DUL (Dubai Unified Licence) bank-integration snapshot with Dubai-wide mainland and free-zone coverage, the CBUAE Open Finance (Al Tareq) live-bank status, the 2026 licensing wave (Tabby, Mal, Revolut, Alaan), and the CMA-replaces-SCA regulator note. The reported 5-day DUL onboarding figure is an average, not a guarantee. |
|
| The boring stuff that breaks setups. Full 5-step UAE legalization chain (UAE is NOT a Hague Apostille member, despite what some sources claim), private-market PRO and legal-translation estimates with official registry links and pricing caveats, current Dubai Chamber membership fee categories and CoO fee, realistic 1-to-16-week banking timelines, and 10 common founder mistakes with impact and fix for each. |
|
| UAE Corporate Tax (Federal Decree-Law 47 of 2022, ordinarily 9% above AED 375,000), Small Business Relief through eligible periods ending 31 December 2029, VAT and QFZP rules, historical ESR scope (2019-2022 obligations and imposed penalties remain; imposed penalties are not refundable), the live e-invoicing pilot (42 pre-approved ASPs, 38 accredited, and 9 in final assessment as of 14 August 2026), new tobacco and vaping minimum excise prices from 1 September 2026, and the unified 14% annual late-payment rate charged monthly for every month or part of a month. The estimator does not apply the ordinary AED 375,000 band or Small Business Relief to a QFZP. |
|
| UAE AML/CFT obligations under the new Federal Decree-Law 10 of 2025 (fines AED 5M-100M for legal persons, virtual assets covered) with DNFBP detection routing to goAML. UBO filing rules under Cabinet Decision 109 of 2023, which superseded Cabinet Decision 58 of 2020. PDPL compliance for UAE federal, DIFC DPL, and ADGM DPR. Plus Emiratisation targets and the AED 10,000/month charge per unfilled position from 1 July 2026. |
|
| Fully reviewed on 14 August 2026: accelerator and incubator search with Hub71 Cohort 20 open through 21 August, subsidized in5 pricing, explicitly verified free-only filtering, and sourced exclusions for misclassified offerings. VC mandates are limited to what current primary sources support. Government support distinguishes MBRIF accelerator and guarantee programs, DFDF dated versus live portfolio snapshots, Dubai SME/Hi2, and Khalifa Fund interest-free loans. |
|
| Cross-linked guide to UAE government portals (MOHRE, ICP, FTA, EmaraTax, GDRFA, Dubai Now, TAS HEEL, Tamm, Tawjeeh) with what each does and which service sits where. |
|
| Dubai Chamber of Digital Economy programs including Dubai Founders HQ, Antler Founder Residency, FRWRDx, Unicorn 30, the Create Apps Championship, and the Canva SME partnership. DCDE has no standalone membership scheme. The duplicate Create Apps record reflects the ongoing Cycle 3 finalist phase and 7 October 2026 final. |
|
| Dubai events calendar refreshed for H2 2026 and 2027: GITEX Global 2026 (7-11 December at Expo City), Expand North Star, Dubai AI Festival, FinTech Summit, Fitness Challenge, the retail festival calendar, World Governments Summit 2027, Dubai Airshow 2027, and the DWTC-to-Expo-City venue shift. |
|
| Dubai Parkin zone tariffs (now VAT-inclusive: 5% VAT since 1 June 2026), the cashless-meter transition, the new International City and Discovery Gardens paid zones, Parkin's 2026 mall-parking expansion, and the Nol Card system with cap rules and RTA coverage. |
|
| UAE trademark registration via MOET: AED 6,500 in regular government fees for one class, a 20-working-day examination target, and a 30-day opposition period. Covers software and brand IP, and correctly notes that new unitary six-state GCC patent filings stopped in 2021. |
|
| Halal certification process via ESMA/UAE.S Halal National Mark, MOIAT import requirements for food, beverages, cosmetics, and pharmaceuticals. |
|
| Dubai Create Apps Championship rules and prize structure. Cycle 3 registration is closed, 12 finalists are in the finalist phase, and the detailed official timeline schedules the final for 7 October 2026; the pack flags a conflicting stale FAQ for reconfirmation before travel. |
|
| Ballpark Dubai living costs (rent ranges by area and bedroom, grocery baskets by household) plus the deterministic rules: DEWA tariff slabs and the 5% residential housing fee, VAT-inclusive Salik toll windows, the KHDA fee freeze for 2026-27, and the August 2026 UAE fuel snapshot (Super 98 AED 3.60, Special 95 AED 3.49, E-Plus 91 AED 3.41, diesel AED 3.80 per litre). H1 2026 inflation context is flagged throughout. |
|
| The Dubai tenancy loop. Ejari registration (documents, fees by channel, timeline, common mistakes), the RERA rent-increase calculator under Dubai Decree 43 of 2013 (bands verified unchanged as of July 2026, plus the 90-day notice rule), Rental Disputes Centre filing (3.5% of annual rent, AED 500 floor, AED 20,000 cap), the new DLD Flexi Rent instalment initiative, and Dubai's shared-housing Law 4 of 2026. |
🤖 Tier 2 agent skills
Feature | Tools | What it does |
|
| Bilingual Arabic/English business letter templates with correct UAE honorifics (HH, HE, HRH, Sheikh, Sheikha), addressee blocks, salutations, and closings. Useful when writing to government entities and senior family. |
|
| Cross-tool planning and Markdown report synthesis. Hands back a sequenced plan (founder_setup, market_research, compliance_checkup, relocation) that the LLM executes step by step, then renders the results as a structured report. |
🧠 Tier 3: meta-tools
Tool | What it does |
| BM25-powered tool discovery. Pass a natural-language query, get a ranked list of the most relevant tools so the LLM does not have to scan all 100-plus at once. |
| List every registered feature with its tier, auth requirement, and tool count. |
| Read the freshness registry. Returns every registered business knowledge domain with its latest recorded |
| Return the package version, knowledge date, live tool count, and repo URL. Useful for clients that want to confirm which version is running without scanning the full catalogue. |
| Session-aware endpoint registry for 16 tracked sources. It returns bootstrap status plus observations made by tools in the current process; it does not proactively probe every endpoint. The table below is a selected point-in-time snapshot, not a complete mirror of the registry. |
🔐 Tier 1: Dubai Pulse OAuth
Feature wrappers for dld (real estate) and rta (transport) ship today with the graceful credential-missing pattern: tools return a structured success: false with setup instructions until you set MCP_DUBAI_PULSE_CLIENT_ID and MCP_DUBAI_PULSE_CLIENT_SECRET. See the credential guide for the full walkthrough.
Feature | Tools | What it does |
|
| Dubai Land Department real estate sale transactions, Ejari rent contracts, and RERA broker lookup. |
|
| RTA metro stations (red and green lines, with Blue Line and Gold Line status notes), bus routes, and the Salik toll tariff (with the 5% VAT note effective June 2026). The |
More Dubai Pulse feature wrappers (DHA health, DEWA, DTCM, DET, Dubai Municipality, Dubai Customs, Dubai Airports) are on the roadmap once specific datasets are requested.
📊 Data Sources
Source | Auth | What we use | Tools |
✅ Open | Prayer times, Qibla, Hijri calendar |
| |
✅ Open | Quran text and translations |
| |
⚠️ Partial, undocumented | Anonymous FX rates; base-rate endpoint recorded blocked |
| |
🔶 Anonymous CKAN, recorded blocked | UAE federal dataset and FCA-trade wrappers |
| |
📚 Bundled snapshot | Curated Dubai school reference data |
| |
✅ Open | METAR / TAF for UAE ICAOs |
| |
✅ Open | Human weather and forecast for UAE cities |
| |
✅ Open | POI fallback |
| |
🔑 Free key | Air quality |
| |
✅ Open | Everyday AED-base currency rates and conversion |
| |
✅ Open (undocumented) | DFM index and stock quotes |
| |
✅ Open (SOAP) | Geo-addressing: Makani numbers, reverse geocoding |
| |
✅ Open (HTML) | DJG retail gold rates, AED per gram |
| |
✅ Open (metadata only) | Dataset catalog search across 76 Dubai entities |
| |
Curated UAE federal calendar | 📚 Static | Public holidays (2026 confirmed, 2027 provisional) |
|
Curated business knowledge files | 📚 Static | Sixteen JSON packs covering free zones, visas, banking, founder essentials, tax compliance, compliance, funding, government portals, DCDE, events, Parkin, IP and trademarks, halal, Create Apps, cost of living, and tenancy; | All 17 Tier 2 business features |
data.dubai API gateway (successor to Dubai Pulse) | 🔐 OAuth | DLD and RTA wrappers today; additional authority wrappers planned | Tier 1 (Phase 4) |
💰 Paid (~AED 31,500/yr per product) | Ejari, Mollak, Trakheesi, Rental Index | Not built (we use Dubai Pulse open data instead) |
Things we will NOT build (full list in the disclaimer): Salik account/balance/trips (private app), NABIDH clinical data (vendor-only PHI), DMCC public-search scraping (ToS-banned), NCM weather wrapper (no public API), DM zoning/parcels (request-only paid), CBUAE Open Finance regulated TPP framework. We also explicitly do not promise A-to-F food grades from the open feed (the consumer app shows them but the open dataset schema is unconfirmed).
Upstream Status
Some government endpoints have deployed bot protection (Cloudflare) since v0.1.0 released. These tools return a structured success: false with error.status of upstream_blocked instead of crashing. The selected table below is a recorded snapshot. get_upstream_status() does not run active probes; it starts from the 16-source bootstrap registry and incorporates observations made by tools during the current process.
Tool or feature | Endpoint | Recorded status | Last checked |
|
| ✅ Working (scraper updated in v0.1.2 for the new Arabic three-cell DOM) | 2026-07-02 |
|
| 🔶 Cloudflare-blocked | 2026-08-14 |
|
| 🔶 Cloudflare-blocked (the same FCSC datasets are browsable on bayanat.ae, which exposes a per-resource REST endpoint) | 2026-08-14 |
|
| 🔶 Cloudflare-blocked | 2026-08-14 |
|
| 🔶 Cloudflare-blocked | 2026-08-14 |
|
| 🔶 Cloudflare-blocked (delegates to | 2026-08-14 |
| Dubai Pulse direct file download | ✅ Working (anonymous 7z download; the old transit.land mirror returns 401) | 2026-08-14 |
|
| ✅ Working (475 securities, with all | 2026-08-14 |
|
| ✅ Working metadata catalog (614 datasets, 11 themes, 76 issuers) | 2026-08-14 |
| Dubai Municipality SOAP service | ✅ Working | 2026-07-02 |
|
| ✅ Working server-rendered rates page | 2026-07-02 |
Portal migration note (2026): the Dubai Pulse portal (www.dubaipulse.gov.ae) was decommissioned between December 2025 and January 2026 and now redirects to data.dubai, run by the Dubai Data and Statistics Establishment. The API gateway moved to apis.data.dubai (same endpoint pattern, still OAuth); the legacy api.dubaipulse.gov.ae host still resolves. The new data_dubai feature searches the portal's credential-free catalog API.
cbuae_exchange_rates rows now include currency (English), currency_ar (Arabic as returned by CBUAE), iso_code (ISO 4217), and rate_aed. Unknown currencies pass through with iso_code: null and currency: null so new CBUAE entries are never silently dropped.
Clients should check result["success"] and read result["error"]["status"] / result["error"]["reason"] for a user-facing message. We track these endpoints and will restore data access when the upstream blocks are lifted or alternative sources are wired up.
⚙️ Configuration
No API credentials are required for 112 of 120 tools in the current source tree. That describes authentication only: the CBUAE base-rate tool and four FCSC tools are currently recorded as blocked upstream. For the full walkthrough of every environment variable, where to get each credential, and step-by-step setup for data.dubai, WAQI, and Calendarific, see the credential guide.
Env Var | Required | Default | Unlocks |
| Tier 1 only |
| The |
| Tier 1 only |
| The |
| No |
| Override the data.dubai API base URL |
| No |
| Override portal URL |
| Air quality only |
|
|
| No |
| Future Calendarific holiday refresh |
| No |
| Log verbosity |
| No |
| HTTP timeout in seconds |
| No |
| Tenacity retry budget |
Every variable is optional. The server starts and registers all 15 Tier 0 features, all 17 Tier 2 business features, and both agent skills without any of them. Individual calls can still depend on a token, OAuth entitlement, or live upstream availability.
📅 Knowledge Freshness
The hardest thing about a Dubai business-knowledge MCP is that the rules move. Tax thresholds, visa criteria, free zone pricing, and even API base URLs all change inside a single quarter. This project handles that with seven mechanisms:
Two freshness timestamps on every curated JSON file:
knowledge_datefor the latest material update andfull_review_datefor the last complete domain review. Targeted refreshes also recordprevious_knowledge_dateandlast_refresh_scopewithout advancingfull_review_date.Per-domain
KNOWLEDGEconstant in everybiz/*module, registered with the sharedKnowledgeRegistryat import time.knowledgeblock on every business tool response withknowledge_date,full_review_date, optionalprevious_knowledge_dateandlast_refresh_scope,volatility,verify_atURL, anddisclaimer.get_knowledge_status()meta-tool that reads from the registry, so a single update flows through automatically.README badge + ⚠️ callout under the maintainer's note.
Volatility tags by domain tied to full-review budgets: 🟢 stable (365 days), 🟡 medium (190 days), 🔴 high (100 days). The checker covers the 16 JSON packs plus
setup_advisor,data_analyst, andarabic_writer. Monthly snapshots and event dates should still be reviewed monthly inside the high-volatility ceiling.Verification queue of open items tracked by maintainers.
Volatility map (current):
Domain | Volatility | Re-verify cadence |
| 🔴 high | 100-day alerting ceiling; monthly for dated snapshots and events |
| 🟡 medium | 190-day alerting ceiling |
| 🟢 stable | 365-day alerting ceiling |
| 🟢 stable | yearly |
| 🟡 medium | re-verify with its underlying tools |
Tier 0 public-data tools | runtime health | bootstrapped from the source registry and updated through session observations, not the pack-age script |
Dubai Pulse dataset slugs (when wired) | manual | re-check after portal or gateway changes; not covered by the pack-age script |
Recent rule changes captured (latest targeted refresh 2026-08-14; check each pack's last_refresh_scope):
Dubai Executive Council Resolution 11 of 2025 took effect on publication in Official Gazette issue 707 on 21 March 2025. Its one-year regularisation period therefore ended on 21 March 2026, not 3 March. The Director General may grant one same-length extension where necessary; the pack does not assume an automatic extension.
DUL is issued across Dubai mainland and free-zone businesses. The official 12 November 2025 update named seven integrated banks and reported a 5-day average account-opening time; a bank missing from that announcement is not proven non-integrated, and the average is not an individual guarantee.
Dubai Chamber membership fees currently span AED 50 to AED 2,200 across official categories. The applicable category depends on legal form, owner nationality, and activity; statutory exemptions and a separate free-zone approval route apply.
UAE e-invoicing pilot is LIVE: the MoF/FTA launched the pilot phase on 1 July 2026 with a Taxpayer Working Group, voluntary adoption open from the same date. The ASP appointment deadline for AED 50M+ revenue businesses was extended to 30 October 2026 (Ministerial Resolution 66 of 2026); go-live stays 1 January 2027. As of 14 August, the official MoF page listed 42 pre-approved providers, 38 accredited providers, and 9 providers under final assessment; these overlapping lists must not be added together.
VAT Law amended by Federal Decree-Law 16 of 2025 (effective 1 January 2026): reverse-charge self-invoicing removed, excess recoverable VAT capped at 5 years, evasion-linked input VAT denial.
Tax Procedures and Excise laws amended by Federal Decree-Law 17 of 2025 (effective 1 January 2026): audit window extendable to 15 years for evasion, 5-year refund claim limit with a 31 December 2026 transition for older balances.
New AML/CFT/CPF framework: Federal Decree-Law 10 of 2025 (in force 14 October 2025) raises fines for legal persons to AED 5M-100M, adds tax evasion as a predicate offence, and explicitly covers virtual assets. Executive regulations in Cabinet Resolution 134 of 2025.
Emiratisation: the H1 2026 deadline for 50+ employee private firms passed 30 June 2026; AED 10,000/month per unachieved position is charged from 1 July 2026.
5% VAT applies to Salik tolls (AED 4.00 to 4.20 standard, AED 6.00 to 6.30 peak) and Parkin parking tariffs from 1 June 2026; cash phased out at Dubai parking meters the same day.
KHDA froze all Dubai private school fees for the 2026-27 academic year (announced 22 May 2026): no ECI increase.
Dubai Law 4 of 2026 regulates shared housing / co-living (operator permits, registry, fines up to AED 1M). The DLD launched Flexi Rent (monthly/quarterly instalments) in June 2026.
Dubai 2-year property investor visa: the AED 750,000 minimum was removed for sole owners (April 2026); co-owners need an AED 400,000 registered share each.
The Dubai Pulse portal was decommissioned (December 2025 to January 2026) and redirects to data.dubai; the API gateway moved to apis.data.dubai. The RTA GTFS feed remains anonymously downloadable as a direct 7z file.
UAE Capital Market Authority (CMA) replaced the SCA effective 1 January 2026 (FDL 32 and 33 of 2025). CBUAE Open Finance (Al Tareq) went live at CBD, FAB, and ADIB; the FDL 6/2025 compliance deadline is 16 September 2026.
2026 holiday observances are confirmed through Hijri New Year: Eid Al Fitr ran 19-22 March (30-day Ramadan), Eid Al Adha 27-29 May with Arafat Day 26 May, and the Hijri New Year day off was moved to Monday 15 June under the transferable-holiday rule. The Prophet's Birthday religious date is provisionally 25 August; no official observance or transfer was announced by 14 August. Commemoration Day (1 December) is a remembrance, not a day off.
UAE e-invoicing legislated by Ministerial Decisions 243 and 244 of 2025 (PINT AE on a DCTCE model). Phased rollout: mandatory for revenue at or above AED 50M from 1 January 2027, below AED 50M from 1 July 2027, government entities from 1 October 2027. Penalties under Cabinet Decision 106 of 2025. Verify dates with the FTA/MoF.
Unified late-payment penalty: a 14% annual rate charged monthly at 14% divided by 12 for every month or part of a month, effective 14 April 2026 under Cabinet Decision 129 of 2025.
Small Business Relief was extended by Ministerial Decision 131 of 2026. Eligible resident persons with revenue at or below AED 3 million may elect relief for tax periods ending on or before 31 December 2029.
Cabinet Decision 137 of 2026 sets minimum excise prices from 1 September 2026: AED 0.40 per cigarette, AED 0.10 per gram of covered water-pipe or ready-to-use tobacco, and AED 1.00 per millilitre of e-liquid.
The August 2026 review also reconciled Create Apps Cycle 3's 7 October final, completed a full primary-source review of all retained funding records, corrected official one-class trademark government fees to AED 6,500, and fixed the post-2021 GCC patent filing position.
QFZP Qualifying Activities were updated by Ministerial Decision 229/2025 (SaaS remains excluded). The calculator applies 0% to qualifying income and 9% to other taxable income without the ordinary AED 375,000 band or Small Business Relief.
CT late-registration penalty waived if first return filed within 7 months (FTA, April 2025).
Golden Visa specialized talent salary tightened to AED 30,000 basic monthly verified over 24 months (early 2026).
ESR is not required for financial years ending after 31 December 2022 under Cabinet Decision 98 of 2024. Historical 2019-2022 obligations remain, and imposed penalties are not refundable.
VARA V2.0 Rulebook compliance deadline 19 June 2025.
Dubai parking spun out of RTA into Parkin Company PJSC, December 2023, with variable tariffs live since 4 April 2025. Note: "Mawaqif" is Abu Dhabi, not Dubai.
Ministry of Economy rebranded to Ministry of Economy and Tourism (MOET) in 2025.
Federal health insurance mandate kicked in January 2025 (UAE-wide).
🏗️ Architecture
src/mcp_dubai/
├── __init__.py
├── __main__.py # python -m mcp_dubai entry point
├── server.py # FastMCP root + meta-tools + explicit feature mounts
├── _shared/
│ ├── auth.py # Dubai Pulse OAuth + availability() pattern
│ ├── constants.py # All base URLs env-overridable
│ ├── discovery.py # BM25 ToolDiscovery + ToolMeta + tier constants
│ ├── http_client.py # async httpx + tenacity retry + typed errors
│ ├── knowledge.py # KnowledgeRegistry singleton
│ └── schemas.py # ToolResponse envelope, KnowledgeMetadata, etc.
├── agents/ # Tier 2 agent skills
│ ├── arabic_writer/
│ └── data_analyst/
├── data/ # Tier 0 + Tier 1 API integrations
│ ├── al_adhan/
│ ├── aviation_weather/
│ ├── air_quality/
│ ├── cbuae/
│ ├── currency/
│ ├── data_dubai/
│ ├── dfm/
│ ├── dld/
│ ├── dubai_pulse/
│ ├── fcsc_ckan/
│ ├── gold_rate/
│ ├── holidays/
│ ├── khda/
│ ├── makani/
│ ├── open_meteo/
│ ├── osm_overpass/
│ ├── quran_cloud/
│ └── rta/
└── biz/ # Tier 2 curated business knowledge
├── _data/ # Curated JSON files (loaded via importlib.resources)
│ ├── free_zones.json
│ ├── visas.json
│ ├── banks.json
│ ├── tax_compliance.json
│ ├── ... (16 packs total)
│ └── loader.py
├── banking/
├── free_zones/
├── setup_advisor/
├── tax_compliance/
├── visas/
└── ... (17 features total)Conventions every feature follows:
__init__.pyexports aFEATURE_METAdict with name, description, tier, requires_auth, source URL.tools.pyholds pure async functions with no FastMCP imports, so unit tests hit the real logic without going through the MCP wrapping layer.server.pydefines aFastMCP("feature_name")instance, decorates wrappers, and registersToolMetarecords with the shared discovery on import.biz/*features additionally expose a per-domainKNOWLEDGE = KnowledgeMetadata(...)constant and callregister_domain_knowledge(domain, KNOWLEDGE)soget_knowledge_status()reflects current freshness automatically.data/*features that need OAuth or a free API key use the graceful credential degradation pattern: tools never crash when env vars are missing. They callavailability()and return a structuredToolResponse.fail({status, reason, docs})so the MCP client renders a help message instead of a stack trace. This is what letspython -m mcp_dubaistart cleanly on a fresh machine with no env file.Curated JSON files use the Pattern 3 envelope: top-level
domain,knowledge_date,full_review_date,volatility,verify_at, anddisclaimer, plusprevious_knowledge_dateandlast_refresh_scopefor targeted updates.source_brief_sectionis retained as an internal research pointer and is not exposed throughKnowledgeMetadata. The shared loader maps the supported metadata fields so a single pack update flows through to every tool that uses it.
💬 Example Queries
Ask your AI assistant any of these. The agent will route to the right tool via recommend_tools and return a grounded answer:
Daily life:
"What time is Fajr prayer tomorrow in Dubai Marina?"
"Convert 10 Ramadan 1447 to Gregorian."
"What's the current AED to USD exchange rate?"
"Find restaurants within 500m of these coordinates."
"Is 2 December 2026 a UAE public holiday?"
"What's today's air quality in Karama?"
"What's today's 22K gold rate in Dubai?"
"How much is petrol in the UAE this month?"
"What building is at Makani 30032 95320?"
"How did the DFM index close today?"
"Find open datasets about traffic on data.dubai."
Schools:
"Find Outstanding rated schools in Jumeirah with British curriculum."
"Which Indian / CBSE schools are under AED 20,000/year?"
Founder questions (the headline value):
"Where should I set up my SaaS company in Dubai with a 25K AED budget?"
"Compare DMCC and IFZA for a 2-visa consultancy."
"What visa should I get if I'm a freelance developer earning AED 400,000/year?"
"Estimate my corporate tax if my free zone SaaS makes AED 1.5M revenue."
"Do I qualify for the Golden Visa with a 32K monthly basic salary?"
"Open a UAE business bank account fast for a solo founder."
"Is Emirates NBD named as DUL-integrated, and does DUL cover a DMCC company?"
"How do I attest my degree certificate from India for use in Dubai?"
"How much do PRO services cost per year for 3 visas?"
"What are the most common mistakes founders make in Dubai?"
🗺️ Roadmap
Phase | Status | Scope |
Phase 1: Scaffold + Shared | ✅ Complete |
|
Phase 2: Tier 0 features | ✅ Complete | 9 initial public-data features: 6 anonymous upstream integrations, 2 bundled static datasets ( |
Phase 3: Tier 2 priority biz | ✅ Complete | setup_advisor, free_zones, visas, banking, founder_essentials, tax_compliance. |
Phase 3b: Tier 2 deferred biz | ✅ Complete | compliance, funding, gov_portals, dcde, events, parkin, ip_trademark, halal, createapps. |
Phase 4: Tier 1 Dubai Pulse scaffolding | ✅ Complete | dubai_pulse base client + dld + rta example features with credential-missing pattern. Ready to wire more features when credentials arrive. |
Phase 5: Polish | ✅ Complete | README, CONTRIBUTING, CI, PyPI publish workflow, issue templates. |
Phase 6: Agent skills | ✅ Complete | arabic_writer (bilingual letter templates) + data_analyst (cross-tool plans + Markdown report synthesis with knowledge-freshness footer). |
Phase 7: Credential-free expansion | ✅ Complete (v0.3.0) | open_meteo (human weather), currency (AED-base converter), cost_of_living pack, tenancy pack (Ejari + RERA rent-increase + RDC), and a tax_compliance refresh (e-invoicing + the unified 14% annual late-payment rate charged monthly). All ship without credentials. |
Phase 8: More Tier 1 features | 🔐 Blocked on credentials | dha, dewa, det, dtcm, dm_food, dm_permits, dubai_customs, dubai_airports. The dubai_pulse base client and dld + rta examples are ready as the template. The RTA GTFS path was re-discovered in v0.4.0 (anonymous direct 7z download); the DLD-from-CSV path remains dead because the new data.dubai portal exposes no anonymous file downloads. |
Phase 9: Scheduled knowledge refresh | ♻️ Ongoing | Review the 19 curated knowledge domains on their declared schedules and advance |
Phase 10: July 2026 expansion | ✅ Complete (v0.4.0 source) | Four new credential-free features (dfm market data, makani geo-addressing, gold_rate, data_dubai catalog search), corrected holiday handling plus a provisional 2027 calendar, the GTFS download fix, a fuel-price tool, an Emiratisation tool, and targeted knowledge corrections. The public PyPI release remains 0.2.0 pending maintainer publication. |
🤝 Contributing
We welcome contributions. Priority areas right now:
Wire up the Phase 8 Tier 1 features (
dha,dewa,det,dtcm,dubai_customs,dubai_airports) once Dubai Pulse credentials land; the base client and the dld/rta examples are the template. The KHDA full-XLSX refresh script is another good starter.Wire up Tier 1 Dubai Pulse features once credentials are obtained. Auth and base client are already in
_shared/auth.pyand theDubaiPulseAuthgraceful-degradation contract is the canonical pattern.Refresh business knowledge on its declared cadence. Each curated JSON file has
knowledge_date,full_review_date, a volatility-based alerting budget, and averify_atURL. Tax rules, visa thresholds, and free zone pricing change frequently.Improve
recommend_toolsBM25 quality by tuning tags. Current quirk: in small sub-corpora, BM25 length normalization can favour shorter tools when queries collide on common tokens.
Read the contribution guide for the dev setup, test/lint commands, and PR checklist.
git clone https://github.com/mahdi-salmanzade/MCP-Dubai.git
cd MCP-Dubai
make dev # editable install with dev + data extras
make check # ruff + mypy + pytest⚠️ Disclaimer
This project is not affiliated with, endorsed by, or sponsored by the Government of Dubai, the United Arab Emirates, or any specific authority (DLD, RTA, KHDA, DSC, DHA, DET, DEWA, CBUAE, Dubai Pulse, MOET, MOIAT, or any other). All data is the property of its respective publisher. We provide a unified interface, nothing more.
Upstream APIs change without warning. If a tool returns wrong, empty, or error results, please open a GitHub issue instead of assuming malice. We rely on the community to keep integrations fresh.
Read the full disclaimer for nature of project, trademarks, compliance responsibilities, removal requests, and personal data handling.
🌟 Acknowledgments
Inspired by mcp-brasil, which proved the pattern for a country-specific public-data MCP server.
Built on FastMCP 3.x, the standalone Pythonic MCP framework maintained by Prefect.
Thanks to the UAE government agencies that publish open data, especially the Federal Competitiveness and Statistics Centre (FCSC) for its credential-free CKAN interface, which is currently recorded as blocked by upstream bot protection.
Built for the Dubai developer community.
📬 Contact
Maintainer: Mahdi Salmanzade, Software Developer, Dubai
Email: mahdi@clrtstudio.com
Issues: https://github.com/mahdi-salmanzade/MCP-Dubai/issues
Pull requests welcome: see the contribution guide
📜 License
MIT. Use it, fork it, ship it. Just keep the attribution and the disclaimer.
Made with ❤️ in Dubai by Mahdi Salmanzade
Built at CLRT Studio
📧 mahdi@clrtstudio.com · 📅 April 2026
هذا المشروع مبادرة مجتمعية مفتوحة المصدر، مرحبًا بمساهماتكم
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceA unified MCP server providing AI agents with 40+ developer APIs including geolocation, crypto prices, DNS lookup, and web scraping. Enables natural language access to various tools through a single gateway.1MIT
- FlicenseAqualityDmaintenanceAn MCP server that gives AI agents access to US business entity data, enabling searches across 9 state registries, SEC EDGAR filings, federal contracts, and lobbying disclosures.61
- AlicenseNot gradedqualityBmaintenanceA comprehensive MCP server that makes official UAE open data queryable through natural language, offering tools for source discovery, dataset search, spatial joins, and intelligence recipes.54MIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server that gives AI assistants access to a multi-agent business operations platform with specialized AI services covering real estate, legal, translation, research, content creation, training, and more.46MIT
Related MCP Connectors
Singapore property & financial data APIs for AI agents. 27 MCP tools. x402 micropayments.
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/mahdi-salmanzade/MCP-Dubai'
If you have feedback or need assistance with the MCP directory API, please join our Discord server