ExirYab

Name: ExirYab
Author: sshnevis

by sshnevisversion 0.1.0i★ –iRuns on your computer

Registry nameio.github.sshnevis/exiryab-mcp

Install

Overview

Description from the maker (original English)

Official read-only ExirYab: find Iranian doctors by name, city and specialty, with clinics and maps.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Other

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: EXIRYAB_MCP_PROXY, EXIRYAB_MCP_BASE_URL

You need

PyPIPython’s uv installed (for the uvx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "exiryab": {
      "command": "uvx",
      "args": [
        "exiryab-mcp"
      ],
      "env": {
        "EXIRYAB_MCP_PROXY": "your-value",
        "EXIRYAB_MCP_BASE_URL": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add exiryab --env EXIRYAB_MCP_PROXY=your-value --env EXIRYAB_MCP_BASE_URL=your-value -- uvx exiryab-mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "exiryab": {
      "command": "uvx",
      "args": [
        "exiryab-mcp"
      ],
      "env": {
        "EXIRYAB_MCP_PROXY": "your-value",
        "EXIRYAB_MCP_BASE_URL": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "exiryab": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "exiryab-mcp"
      ],
      "env": {
        "EXIRYAB_MCP_PROXY": "your-value",
        "EXIRYAB_MCP_BASE_URL": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

EXIRYAB_MCP_PROXY env
Optional HTTP proxy URL for every request. System proxy settings are ignored.
EXIRYAB_MCP_BASE_URL env
Optional API base URL (default https://exiryab.com), e.g. a local ExirYab for development.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account sshnevis, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Otheri

More stars than 0% of the other 32545 servers in this category
Published to the registry more recently than 62% of the other 32545 servers in this category
Basic checks equal to or better than 100% of the other 32545 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is ExirYab safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.1.0) reached the registry 23 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, Python MCP

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Runs on your computer★ 440MITUpdated 14 months ago

Install

Remote Desktop Commander

by desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Runs in the cloud★ 211Updated yesterday

Install

Python MCP

by Files-com

Local-only Python MCP server for the Files.com API.

Runs on your computerUpdated today

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

🩺 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.

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 Code

claude mcp add exiryab -- uvx exiryab-mcp

Claude Desktop

Settings → Developer → Edit Config, then add:

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

</details>

Cursor

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

VS Code (Copilot agent mode)

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

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

</details>

Anything else

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

Tool	What it does
`ey_search_doctors`	Best match plus alternatives for a name, city (or province) and specialty, with profile URL, clinics, phones, hours and map links
`ey_cities`	Cities with doctors, their province and doctor count, most doctors first
`ey_specialties`	Specialties with doctor count and parent specialty, most doctors first

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

Is there an ExirYab API for AI agents?

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.

Is it official, safe and free?

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.

Can it book an appointment?

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

A tool says "rate limiting requests"

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

Claude Desktop says uvx is not found

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

How do I debug what the agent sees?

npx @modelcontextprotocol/inspector uvx exiryab-mcp

Configuration

Variable	Default	Meaning
`EXIRYAB_MCP_PROXY`	unset	HTTP proxy for every request, e.g. `http://user:pass@host:port`
`EXIRYAB_MCP_BASE_URL`	`https://exiryab.com`	API base URL, e.g. a local ExirYab for development

فارسی: سرور 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

ExirYab

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

Python MCP

README from the maker

🩺 exiryab-mcp: ExirYab MCP server for AI agents

For AI agents

Why

What it can do

Quick start

How it works

Tools

Good to know

FAQ

Configuration

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

Development

Related servers

Disclaimer

License