🩺 exiryab-mcp: ExirYab MCP server for AI agents

Official, read-only MCP server that lets your AI agent find Iranian doctors on ExirYab (اکسیریاب, exiryab.com). Search by name, city and specialty, and get the doctor's profile link, clinics, phones, working hours and map location (Google Maps, Neshan, Balad), all from Claude, Cursor or Copilot.

Quick start · What it can do · Tools · FAQ · فارسی

For AI agents

• What: Official MCP server for ExirYab (اکسیریاب, exiryab.com), a directory of Iranian doctors. Queries in Persian work best.

• Install: claude mcp add exiryab -- uvx exiryab-mcp (stdio, needs uv and Python 3.10+).

• Auth: none. Optional EXIRYAB_MCP_PROXY sets an HTTP proxy for every request.

• Access: read-only. There is no booking or login; give the user the doctor's profile url and clinic phones.

• Tools: 3, all prefixed ey_: ey_search_doctors, ey_cities, ey_specialties.

• Typical sequence: ey_search_doctors -> (if a name or word is unclear) ey_cities / ey_specialties -> ey_search_doctors again.

• Use when: the user wants to find a specific doctor or the best doctors of a specialty in an Iranian city, with address, phone, hours and map.

• Do not use when: the user needs medical advice, or wants to book or pay online.

• Output: compact JSON. A best_match plus alternatives, a confidence (high, medium, low, ranking, none) and warnings. Clinic weekly_hours maps an English weekday to shifts ([] = closed).

• Skill: skills/exiryab/SKILL.md has the usage rules for agents.

• Machine-readable: server.json, the site's llms.txt, and the catalog of Iranian MCP servers awesome-iran-mcp.

Related MCP server: Oscar Health Provider MCP

Why

ExirYab (exiryab.com) lists doctors across Iran with their specialties, offices, hospitals and clinics. People usually remember half a name ("Dr. Mohammadi, the cardiologist in Tehran"), and the agent has to turn that into the right person and tell them where to go. exiryab-mcp calls ExirYab's public API, which does the name matching on the server (titles, Arabic letters, spacing, partial names) and returns the best match with alternatives:

You: Find Dr. Malek Mohammadi, a cardiologist in Tehran. Where is the office?

Agent: calls ey_search_doctors(name="ملک محمدی", city="تهران", specialty="قلب")

Dr. Mousa Malek Mohammadi (cardiology, Tehran). Profile: https://exiryab.com/dr/36370-.../ I also found other cardiologists in Tehran if you want alternatives.

What it can do

• 🔎 Find a doctor by name, full or partial, with optional city and specialty, and tell you how sure the match is

• 🏆 Top doctors of a specialty in a city or a whole province when no name is given

• 🏥 Clinics: type (office, hospital, clinic), address, district, phones, working hours per weekday

• 🗺️ Map location: coordinates plus Google Maps, directions, Neshan and Balad links

• 🏷️ Resolve words: Persian city and specialty names, with doctor counts

• 🔒 Read-only by design: no login, no booking, no payment

Quick start

You need uv.

claude mcp add exiryab -- uvx exiryab-mcp

Settings → Developer → Edit Config, then add:

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

Click Install in Cursor above, or add the Claude Desktop block to ~/.cursor/mcp.json.

Click Install in VS Code above, or add to .vscode/mcp.json:

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

It's a standard stdio MCP server: run uvx exiryab-mcp, or pip install exiryab-mcp and run exiryab-mcp.

Then just ask:

• "Find Dr. Mohammadi, the cardiologist in Tehran, and give me the office phone."

• "The best pediatricians in Fars province, with a map link."

• "Which heart specialties are there, and how many doctors does each have?"

• دکتر ملک محمدی متخصص قلب در تهران را پیدا کن و آدرس مطبش را روی نشان بده.

How it works

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  exiryab-mcp  (runs on your machine)
      │
      │  HTTPS (JSON)
      └──────▶  exiryab.com/api/v1  (doctors/search, cities, specialties)

The API is public and needs no key. It is limited to 60 requests per minute per IP and answers are cached for up to a day.

Tools

All 3 tools are annotated readOnlyHint: true and return compact structured JSON.

Good to know

• Persian input works best. Titles such as «دکتر» are ignored, and «ي»/«ك» and spacing differences are handled on the server.

• City words in the name are used as filters: name="محمدی قلب تهران" searches for Mohammadi among Tehran cardiologists.

• A province works as a city: city="فارس" searches the whole province.

• Filters can be dropped: when a name matches nobody with the given specialty or city, the server drops that filter and says so in understood.dropped_filters and warnings.

• confidence: high = one clear match; medium = a good match but others are close, so confirm with the user; low = weak matches only; ranking = no name was given; none = nothing found.

• similar alternatives are padding (same specialty and area), not people with the name you asked for.

• verified means the medical council card was checked and the mobile confirmed; managed_by_doctor means the doctor confirmed their mobile.

FAQ

Yes. ExirYab publishes a small public JSON API at https://exiryab.com/api/v1 (search, cities, specialties), and this MCP server wraps it for Claude, Cursor and Copilot.

It is official (made by ExirYab), open source (MIT) and free. It is read-only, needs no account or API key, and runs on your machine.

No. It gives the doctor's profile link and clinic phones; booking happens with the doctor or on the profile page.

The API allows 60 requests per minute per IP. Wait a minute and try again.

Use the full path to uvx (where uvx on Windows, which uvx on macOS/Linux) as command.

npx @modelcontextprotocol/inspector uvx exiryab-mcp

Configuration

فارسی: سرور MCP اکسیریاب

exiryab-mcp سرور MCP رسمی اکسیریاب است که به دستیار هوش مصنوعی شما (Claude، Cursor، Copilot و ...) اجازه می‌دهد پزشکان ایران را با نام، شهر و تخصص پیدا کند و لینک صفحه پزشک، مطب‌ها، تلفن‌ها، ساعت کاری و موقعیت روی نقشه (گوگل‌مپ، نشان، بلد) را بگیرد.

• فقط خواندنی است: ورود، نوبت‌دهی و پرداخت ندارد.

• نام پزشک را کامل یا ناقص بنویسید؛ «دکتر» و تفاوت «ی/ي» و فاصله‌ها در سرور حل می‌شود.

• به جای شهر می‌توانید نام استان را بدهید.

• روی سیستم خود شما اجرا می‌شود و فقط به API عمومی exiryab.com وصل می‌شود.

نصب در Claude Code:

claude mcp add exiryab -- uvx exiryab-mcp

بعد بپرسید: «یک متخصص اطفال خوب در شیراز با آدرس و لینک نقشه.»

Development

git clone https://github.com/sshnevis/exiryab-mcp && cd exiryab-mcp
uv sync
uv run pytest            # offline, against recorded responses
uv run pytest -m live    # real API (EXIRYAB_MCP_LIVE_BASE_URL=http://localhost:5082 for a local ExirYab)
uv run ruff check .

Tools live in src/exiryab_mcp/doctors.py and lookup.py; each is a typed async function with a docstring that tells the agent when to use it.

Releases: bump the version in pyproject.toml and server.json, then push a v* tag. GitHub Actions tests, publishes to PyPI and the MCP Registry, and creates the GitHub Release.

Related servers

• Paziresh24 MCP server and Doctoreto MCP server for appointment times and visit fees

• All Iranian MCP servers: awesome-iran-mcp

Disclaimer

The directory is for finding doctors and is not medical advice. Please keep request rates reasonable.

License

MIT