npm package: @khaleejiapi/mcp-server
Description: Model Context Protocol (MCP) server for KhaleejiAPI — expose 26+ MENA APIs as AI agent tools
Author: KhaleejiAPI
Latest version: 1.1.0

# @khaleejiapi/mcp-server

Model Context Protocol (MCP) server for [KhaleejiAPI](https://khaleejiapi.dev) — 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

```bash
# Install and run
KHALEEJI_API_KEY=your_key npx @khaleejiapi/mcp-server
```

Get a free API key at [khaleejiapi.dev/signup](https://khaleejiapi.dev/signup) (1,000 requests/month).

## Configuration

### Claude Desktop

Add to `claude_desktop_config.json`:

```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`:

```json
{
  "servers": {
    "khaleejiapi": {
      "command": "npx",
      "args": ["@khaleejiapi/mcp-server"],
      "env": {
        "KHALEEJI_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

### Cursor

Add to Cursor settings → MCP Servers:

```json
{
  "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