Lets an AI agent find Iranian doctors by name, city, and specialty, providing clinic details, contact information, and map locations.
Also known as sshnevis/exiryab-mcp, exiryab-mcp
- Stars
- 1
- Tools
- 3
- Downloads, 30 days
- —
- Latest version
- 0.1.0
- Last commit
- Nov 1, 2026
- License
- MIT
What is ExirYab MCP?
ExirYab lets an AI agent find Iranian doctors by name, city, and specialty, providing clinic details, contact information, and map locations. It exposes 3 tools, such as ey_search_doctors, ey_cities, ey_specialties.
Summary generated from the project's README
About ExirYab MCP server
Finding medical professionals in Iran is what ExirYab enables for developers using AI clients like Claude, Cursor, or Copilot. This official, read-only MCP server connects your agent to a directory of Iranian doctors, allowing for searches based on name, city, or medical specialty. It provides essential details such as clinic addresses, phone numbers, working hours, and direct links to map services like Google Maps, Neshan, or Balad.
The server runs locally on your machine via stdio and requires Python 3.10+ and the uv tool for installation. It does not require any API keys or user accounts, making it easy to set up for quick queries. Users can interact with three specific tools: ey_search_doctors for finding individuals, ey_cities to browse locations, and ey_specialties to explore medical fields. The system is designed to handle Persian queries effectively, including variations in character spacing and titles.
While the server provides high-quality contact information and location data, it is strictly for information retrieval. It cannot be used for booking appointments, making payments, or providing medical advice. The public API used by the server is limited to 60 requests per minute per IP address.
What you can do with it
- 1Locate a specific doctorFind a doctor's office location and phone number using only a partial name and city.
- 2Discover specialists by regionIdentify the top medical specialists available within a specific Iranian province.
- 3Explore medical specialtiesList available medical fields and see how many doctors are registered under each one.
- 4Get clinic operating hoursRetrieve the weekly schedule for a specific clinic to know when they are open.
Written from the project's README. Every use case is checked against a quote from it.
How to install ExirYab MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall ExirYab MCP in Claude Code
$ claude mcp add exiryab-mcp -- uvx exiryab-mcpInstall ExirYab MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"exiryab-mcp": {
"command": "uvx",
"args": [
"exiryab-mcp"
]
}
}
}Install ExirYab MCP in VS Code
.vscode/mcp.json
{
"servers": {
"exiryab-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"exiryab-mcp"
]
}
}
}Install ExirYab MCP in VS Code CLI
$ code --add-mcp '{"name":"exiryab-mcp","type":"stdio","command":"uvx","args":["exiryab-mcp"]}'Install ExirYab MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"exiryab-mcp": {
"command": "uvx",
"args": [
"exiryab-mcp"
]
}
}
}Install ExirYab MCP in Codex
$ codex mcp add exiryab-mcp -- uvx exiryab-mcpInstall ExirYab MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.exiryab-mcp] command = "uvx" args = ["exiryab-mcp"]
Install ExirYab MCP in Gemini CLI
$ gemini mcp add -s user exiryab-mcp uvx -- exiryab-mcpInstall ExirYab MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"exiryab-mcp": {
"command": "uvx",
"args": [
"exiryab-mcp"
]
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for exiryab-mcp 0.1.0 in an isolated container with no network and no keys. It answered and listed 3 tools.
ExirYab MCP tools 3
Read from the server with tools/listey_search_doctorsRead-onlyFind an Iranian doctor on exiryab.com by name, city and/or specialty: the best match plus alternatives, each with profile URL, clinics, phones, working hours and map links. Give at least one of name, city, specialty (Persian works best). With a name, the server ranks by how well the name matches and drops filters that leave no match (see `understood.dropped_filters` and `warnings`). Without a name, it returns the top-ranked doctors for the city and specialty. `confidence`: high = one clear match for the name; medium = a good match but others are close, so confirm with the user; low = only weak name matches; ranking = no name was given; none = nothing found. `match.kind` per doctor: name, partial_name, similar (padding: same specialty and area, not the name asked for) or ranking. Clinic `weekly_hours` maps an English day to its shifts ('17:00-19:00'); an empty list means closed that day.
ey_citiesRead-onlyCities that have doctors on exiryab.com, with their province and doctor count, most doctors first. Use it to find the exact Persian city name for ey_search_doctors(city=...), or to check whether a town is covered. `total` counts every match, not only the ones returned.
ey_specialtiesRead-onlyMedical specialties on exiryab.com with their doctor count, most doctors first; sub-specialties name their `parent`. Use it to turn a word like 'قلب' or 'پوست' into the exact specialty for ey_search_doctors(specialty=...) when the user's word is ambiguous (heart: «قلب و عروق» cardiology or «جراح قلب» heart surgery).
Configuration
EXIRYAB_MCP_BASE_URLOptional API base URL (default https://exiryab.com), e.g. a local ExirYab for development.
EXIRYAB_MCP_PROXYOptional HTTP proxy URL for every request. System proxy settings are ignored.
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHub🩺 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_PROXYsets an HTTP proxy for every request. - Access: read-only. There is no booking or login; give the user the doctor's profile
urland 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_doctorsagain. - 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_matchplusalternatives, aconfidence(high,medium,low,ranking,none) andwarnings. Clinicweekly_hoursmaps 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 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
| 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_filtersandwarnings. 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.similaralternatives are padding (same specialty and area), not people with the name you asked for.verifiedmeans the medical council card was checked and the mobile confirmed;managed_by_doctormeans 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
| 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
ExirYab MCP questions
How do I add ExirYab MCP to Claude Code?
Run claude mcp add exiryab-mcp -- uvx exiryab-mcp in your terminal. Add --scope user to make it available in every project.
How do I add ExirYab MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does ExirYab MCP provide?
It exposes 3 tools, including ey_search_doctors, ey_cities, ey_specialties.
Is there an ExirYab API for AI agents?
Yes, ExirYab publishes a public JSON API that this MCP server wraps for use with Claude, Cursor, and Copilot.
Is it official, safe and free?
Yes, it is an official, open-source (MIT) server that is free to use and runs locally on your machine without needing an account.
Can it book an appointment?
No, the server is read-only and only provides profile links and clinic phone numbers; booking must be done directly with the doctor.
What should I do if I see a 'rate limiting requests' error?
The API allows up to 60 requests per minute per IP. Simply wait one minute and try your request again.