# ExirYab

> ExirYab is an open-source MCP server for health and science. Find Iranian doctors by name, city and specialty with clinics and maps. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI, API
- **Website:** https://exiryab.com
- **Repository:** https://github.com/sshnevis/exiryab-mcp
- **MCP Registry name:** io.github.sshnevis/exiryab-mcp
- **Categories:** health and science, maps and travel
- **Listing updated:** 2026-11-15

## About

The server wraps the public API of the ExirYab doctor directory, so name matching happens on the service side. It copes with titles, Arabic letter variants, spacing and partial names, and replies with a best match, a list of alternatives and a confidence level (high, medium, low, ranking or none), plus warnings when the match is shaky.

When no name is given it can return the top doctors of a specialty for a city or a whole province. Each result carries the profile link, the clinics (office, hospital or clinic) with address, district, phones and weekly opening hours, and map coordinates with Google Maps, Neshan and Balad links. Queries in Persian work best.

It is read-only: there is no login, booking or payment, and the README tells agents not to use it for medical advice. It runs locally over stdio through uvx and needs Python 3.10 or newer.

## Features

- **Fuzzy name search:** Matches full or partial doctor names and reports how sure the match is.
- **Top doctors by specialty:** Lists leading doctors of a specialty for a city or province when no name is given.
- **Clinic details:** Returns clinic type, address, district, phones and weekly working hours.
- **Map links:** Gives coordinates and Google Maps, directions, Neshan and Balad links.
- **City and specialty lookup:** Resolves Persian city and specialty names, with doctor counts.
- **Read-only access:** No login, booking or payment is involved.

## Good for

- Look up a half-remembered doctor name in a given city
- Find cardiologists or other specialists in an Iranian city
- Get a clinic's phone numbers and opening hours inside a chat
- Share a map link to a doctor's office

## Install

### Claude Code (Terminal)

```sh
claude mcp add exiryab-mcp -- uvx exiryab-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "exiryab-mcp": {
      "command": "uvx",
      "args": [
        "exiryab-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "exiryab-mcp": {
      "command": "uvx",
      "args": [
        "exiryab-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "exiryab-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "exiryab-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "exiryab-mcp": {
      "command": "uvx",
      "args": [
        "exiryab-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "exiryab-mcp": {
      "command": "uvx",
      "args": [
        "exiryab-mcp"
      ]
    }
  }
}
```

## Tools

- `ey_search_doctors`: Searches doctors by name, city and specialty and returns a best match with alternatives.
- `ey_cities`: Resolves Persian city names and shows doctor counts.
- `ey_specialties`: Resolves specialty names and shows doctor counts.

## FAQ

### Does it need an account or API key?

No. It has no authentication; an optional EXIRYAB_MCP_PROXY variable sets an HTTP proxy for requests.

### Can it book appointments?

No. It is read-only and only returns profile links, phones, hours and map locations.

### Which tools does it expose?

Three: ey_search_doctors, ey_cities and ey_specialties.

### What language should I search in?

Persian queries work best, according to the README.

### Is ExirYab free?

Yes. ExirYab is open source, so you can use and self-host it for free.

### How do I add ExirYab to Claude Code?

Run this command in your terminal: claude mcp add exiryab-mcp -- uvx exiryab-mcp

### What are the best alternatives to ExirYab?

The closest alternatives to ExirYab are Tooluniverse, Oya Browser, Tutu eSIM, Later Stages and Shanghai Streets Travel Guide.

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.

---
Source: https://ai-powered.com/mcp/exiryab
