# worldref MCP server

> Provides comprehensive country data including names in Arabic and English, nationalities, dial codes, phone validation, and address formats.

- Repository: https://github.com/arj-89/worldref
- Page: https://hostedmcp.org/servers/arj-89/worldref
- Transport: stdio
- Stars: 0
- Latest version: 1.2.1

## Install

### Claude Code

```sh
claude mcp add worldref -- npx -y worldref
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "worldref": {
      "command": "npx",
      "args": [
        "-y",
        "worldref"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "worldref": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "worldref"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"worldref","type":"stdio","command":"npx","args":["-y","worldref"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "worldref": {
      "command": "npx",
      "args": [
        "-y",
        "worldref"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add worldref -- npx -y worldref
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.worldref]
command = "npx"
args = ["-y", "worldref"]
```

### Gemini CLI

```sh
gemini mcp add -s user worldref npx -- -y worldref
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "worldref": {
      "command": "npx",
      "args": [
        "-y",
        "worldref"
      ]
    }
  }
}
```

## FAQ

### What languages does worldref support?

The dataset provides country names, nationalities, and other information in both Arabic and English.

### How does the Arabic search function work?

The search ignores the definite article «ال», removes tashkeel and tatweel, and treats various Arabic character forms (like different hamza or alef types) as equivalent.

### Can I use this for phone number validation?

Yes, it includes dial codes, valid lengths, mobile prefixes, and exact validation patterns for every country, supporting E.164 output.

### Is the data sourced from reliable places?

Yes, the data is sourced from official entities like Unicode CLDR, Google libphonenumber, World Bank, IANA, ITU, and government sources.
