@khaleejiapi/mcp-server

Model Context Protocol (MCP) server for KhaleejiAPI — the MENA region's developer API platform.

Exposes all 26 KhaleejiAPI endpoints as MCP tools that AI agents (Claude, GitHub Copilot, Cursor, Windsurf, etc.) can call directly.

Quick Start

# Install and run
KHALEEJI_API_KEY=your_key npx @khaleejiapi/mcp-server

Get a free API key at khaleejiapi.dev/signup (1,000 requests/month).

Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "khaleejiapi": {
      "command": "npx",
      "args": ["@khaleejiapi/mcp-server"],
      "env": {
        "KHALEEJI_API_KEY": "your_api_key_here"
      }
    }
  }
}

VS Code / GitHub Copilot

Add to .vscode/mcp.json:

{
  "servers": {
    "khaleejiapi": {
      "command": "npx",
      "args": ["@khaleejiapi/mcp-server"],
      "env": {
        "KHALEEJI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor

Add to Cursor settings → MCP Servers:

{
  "khaleejiapi": {
    "command": "npx",
    "args": ["@khaleejiapi/mcp-server"],
    "env": {
      "KHALEEJI_API_KEY": "your_api_key_here"
    }
  }
}

Available Tools (22)

Validation

| Tool | Description | |------|-------------| | validate_email | Validate email with MX, disposable, and role checks | | validate_phone | Validate phone with carrier and type detection | | validate_vat | Validate UAE/GCC VAT/TRN numbers | | validate_iban | Validate IBAN with bank info (MENA optimized) | | validate_emirates_id | Validate UAE Emirates ID (Luhn algorithm) | | validate_saudi_id | Validate Saudi National ID or Iqama | | validate_saudi_id_batch | Batch validate up to 100 Saudi IDs |

Geolocation

| Tool | Description | |------|-------------| | ip_lookup | IP geolocation with ISP and threat data | | get_timezone | Timezone data with DST support | | geocode | Address to coordinates (100+ MENA locations) |

Finance

| Tool | Description | |------|-------------| | get_exchange_rates | Real-time currency rates (160+ currencies) | | calculate_vat | GCC VAT calculation with auto rate detection | | get_holidays | Public holidays for 6 GCC countries | | get_business_days | Business day calculations (GCC weekends + holidays) |

Communication

| Tool | Description | |------|-------------| | translate | AI translation via Google Gemini (22+ languages) | | shorten_url | URL shortener with custom aliases |

Islamic

| Tool | Description | |------|-------------| | convert_hijri | Gregorian ↔ Hijri calendar conversion | | get_prayer_times | Prayer times with Qibla direction | | process_arabic_text | Arabic NLP (7 operations) |

Utility

| Tool | Description | |------|-------------| | generate_qr_code | QR code generation with custom styling | | fraud_check | Fraud detection with risk scoring | | get_weather | Real-time weather + 7-day forecast |

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | KHALEEJI_API_KEY | Yes | — | Your KhaleejiAPI key | | KHALEEJI_BASE_URL | No | https://khaleejiapi.dev/api/v1 | API base URL |

License

MIT