<!--badge:health_checks--> <!--badge:datasets--> <!--badge:fees--> <!--badge:sources_total-->

Invest Gate KSA

Architecture

How a question becomes a verified answer

Interactive System Map

Explore how an investor question moves through the MCP tools, bilingual datasets, verification layer, and source-linked response.

The interactive guide is deployed through GitHub Pages. You can also view its source.

The investor asks in Arabic or English → Claude Desktop routes through <!--count:mcp_tools-->10<!--/count--> MCP tools → the server queries <!--count:datasets-->11<!--/count--> bilingual datasets → every response cites its official source with a verification status (✓ verified from an official source / ⚠ draft pending verification).

<p align="center"> <img src="assets/images/repo-cover.png" alt="Invest Gate KSA Cover" width="100%"> </p>

A bilingual, open-source knowledge infrastructure for understanding investment, company setup, licensing, and business operations in Saudi Arabia.

---

Disclaimer This repository contains general educational information only. It is not legal, financial, regulatory, or tax advice. Laws, fees, and procedures in Saudi Arabia change — always verify information directly with official government sources and consult qualified practitioners before making any decision.

---

The Problem

Saudi Arabia has opened significantly to foreign investment. But for an investor arriving from outside the Kingdom, the path is genuinely hard to navigate: information is scattered across a dozen government portals, often in Arabic only, frequently outdated on third-party sites, and rarely organized around the questions investors actually ask.

The result is that many foreign investors rely on expensive consultants for information that should be freely accessible — or worse, proceed on misinformation.

---

What This Is

Invest Gate KSA is a structured, community-maintained knowledge repository that organizes publicly available information about investing in Saudi Arabia into clear, source-linked, bilingual documentation — and exposes it through a working MCP server for conversational AI querying.

It is not a consultancy. It is not a legal service. It is a reference framework — designed to be accurate, traceable, and queryable.

---

Quick Start

Option A — Query the datasets directly (CLI)

# Clone
git clone https://github.com/Samix2026/invest-gate-ksa.git
cd invest-gate-ksa

# Install
pip3 install -r scripts/requirements.txt

# Query fee schedule
python3 scripts/query-dataset.py --dataset fees --lang en --list

# Query sectors (Arabic)
python3 scripts/query-dataset.py --dataset sectors --lang ar --list

# Query Special Economic Zones
python3 scripts/query-dataset.py --dataset sezs --lang en --list

# Search across all datasets
python3 scripts/query-dataset.py --dataset all --keyword "MISA" --lang en

Option B — Connect to Claude Desktop (MCP)

pip3 install -r mcp/requirements.txt

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "invest-gate-ksa": {
      "command": "python3",
      "args": ["/absolute/path/to/invest-gate-ksa/mcp/invest_gate_mcp.py"]
    }
  }
}

Restart Claude Desktop. Then ask:

• "What are the steps to register a company in Saudi Arabia as a foreign investor?"
• "ما رسوم التسجيل في وزارة الاستثمار؟"
• "What are the tax obligations for a foreign company in Saudi Arabia?"

Option C — Use the data directly in your project

import json

with open('data/fees.en.json') as f:
    fees = json.load(f)

for entry in fees['data']:
    if entry.get('verification_status') == 'verified' and entry.get('amount_sar', 0) != 0:
        print(f"{entry['id']}: SAR {entry['amount_sar']} ({entry.get('frequency', '')})")

---

Example Output

Fee schedule query (--dataset fees --lang en --list) currently returns:

fees  (en)  —  26 entries
20 verified · 6 draft

Sector query, Arabic (--dataset sectors --lang ar --list):

sectors  (ar)  —  16 entries
────────────────────────────────────────────────────────────────────────────────
  ID                                NAME                          STATUS
────────────────────────────────────────────────────────────────────────────────
  technology                        التقنية                       draft
  consulting                        الاستشارات والخدمات المهنية   draft
  ecommerce                         التجارة الإلكترونية           draft
  food_and_beverage                 الأغذية والمشروبات            draft
  real_estate                       العقارات                      draft
  education                         التعليم                       draft
  healthcare                        الرعاية الصحية                draft
  fintech                           التقنية المالية (فينتك)       draft
  manufacturing                     التصنيع                       draft
  industrial_services               الخدمات الصناعية              draft
  mining                            التعدين والموارد المعدنية     draft
  tourism_and_hospitality           السياحة والضيافة              draft
  media_and_content                 الإعلام والمحتوى              draft
  hajj_umrah_services               خدمات الحج والعمرة            draft
  entertainment_and_events          الترفيه والفعاليات            draft
────────────────────────────────────────────────────────────────────────────────
  16 entry/entries

SEZ query (--dataset sezs --lang en --list):

sezs  (en)  —  5 entries
────────────────────────────────────────────────────────────────────────────────
  ID                                NAME                          STATUS
────────────────────────────────────────────────────────────────────────────────
  kaec_sez                          King Abdullah Economic City … verified
  jazan_sez                         Jazan Special Economic Zone   verified
  ras_al_khair_sez                  Ras Al-Khair Special Economi… verified
  cloud_computing_sez               Cloud Computing Special Econ… verified
  silz                              Special Integrated Logistics… draft
────────────────────────────────────────────────────────────────────────────────
  5 entry/entries

---

Who This Is For

| Audience | How they use it | |---|---| | Foreign entrepreneurs and investors | Understand the regulatory landscape before engaging advisors | | Business setup consultants | Reference and share structured process guides | | Researchers and academics | Source-linked overview of the Saudi investment framework | | Developers | Knowledge base for building investment-related tools and AI assistants | | Translators and bilingual professionals | Arabic-English alignment of business and regulatory terminology |

---

Use Cases

For developers:

• Build an investment guidance chatbot for Saudi Arabia
• Power an AI agent with structured regulatory data
• Integrate via MCP with Claude Desktop or any MCP-compatible client

For founders and investors:

• Understand the full regulatory path before engaging consultants
• Compare business structures (LLC vs Branch vs RHQ)
• Verify fee estimates against official sources

For researchers:

• Structured, bilingual, source-linked regulatory dataset
• Tracks data gaps explicitly — <!--count:source_gaps-->23<!--/count--> source gaps documented
• Versioned via Git with full change history

For AI/LLM builders:

• <!--count:datasets-->11<!--/count--> JSON datasets with strict schema (Draft-07)
• Bilingual EN/AR with ID parity enforcement
• MCP server with <!--count:mcp_tools-->10<!--/count--> tools — plug into any MCP-compatible agent
• System prompt included for out-of-the-box AI assistant deployment

---

What's Inside

| Directory / File | Contents | |---|---| | data/ | <!--count:datasets-->11<!--/count--> structured bilingual JSON datasets (EN + AR) | | data/sectors | <!--count:sectors-->16<!--/count--> investment sectors with Vision 2030 alignment | | data/sources | <!--count:sources_total-->17<!--/count--> source registry entries — <!--count:sources_verified-->5<!--/count--> verified, <!--count:sources_draft-->12<!--/count--> draft | | data/source-gaps | <!--count:source_gaps-->23<!--/count--> tracked data gaps awaiting verification | | data/fees | <!--count:fees-->26<!--/count--> fee entries — <!--count:fees_verified-->20<!--/count--> verified, <!--count:fees_draft-->6<!--/count--> draft | | data/timelines | <!--count:timelines-->12<!--/count--> processing time entries — <!--count:timelines_verified-->8<!--/count--> verified, <!--count:timelines_draft-->4<!--/count--> draft | | data/sezs | <!--count:sezs-->5<!--/count--> Special Economic Zones (KAEC, Jazan, Ras Al-Khair, Cloud, SILZ) | | data/economic-activities | <!--count:economic_activities-->21<!--/count--> economic activities — <!--count:economic_activities_verified-->10<!--/count--> verified, <!--count:economic_activities_draft-->11<!--/count--> draft | | data/setup-flows | <!--count:setup_flows-->4<!--/count--> registration flows by scenario (consulting, e-commerce, manufacturing, fintech) | | data/business-structures | <!--count:business_structures-->4<!--/count--> entity types (LLC, JSC, Branch Office, Representative Office) | | data/authority-relationships | <!--count:authority_relationships-->12<!--/count--> regulatory authority relationship mappings | | data/investment-licenses | <!--count:investment_licenses-->5<!--/count--> registration and licensing concepts in setup sequence | | schemas/ | JSON Schema Draft-07 — strict typing, additionalProperties: false | | docs/en/ | English guides: registration, tax, SEZs, Vision 2030, structures | | docs/ar/ | Arabic mirrors (RTL) — full bilingual parity enforced | | mcp/ | FastMCP server — <!--count:mcp_tools-->10<!--/count--> query tools for Claude Desktop integration | | .claude/commands/ | <!--count:commands-->6<!--/count--> slash commands for daily repository operations | | prompts/ | AI system prompt (bilingual, citation rules, legal disclaimer) | | scripts/ | <!--count:health_checks-->189<!--/count-->-check validation suite (JSON, schema, parity, cross-refs) | | sources/ | Citation registry — every claim source-linked | | templates/ | LLC, branch, MISA document, and source-review checklists | | .github/workflows/ | CI/CD — validation on every push and PR |

---

Core Coverage

• Full regulatory path: MISA → CR → Chamber of Commerce → ZATCA → GOSI → Qiwa → Muqeem
• Registration types: Standard Investment Registration, RHQ, Entrepreneurial
• Tax framework: CIT 20% (foreign), Zakat 2.5% (Saudi/GCC), VAT 15%, WHT 5–20%
• Special Economic Zones: KAEC, Jazan, Ras Al-Khair, Cloud Computing, SILZ (5% CIT)
• Vision 2030 sector alignment: <!--count:sectors-->16<!--/count--> sectors with official targets and supervising entities
• Fee schedules and processing timelines — verified against official sources
• 2025 regulatory updates: new CR Law (April 2025), Investment Law (August 2024)

---

Project Status

| Ph