ExirYab

Name: ExirYab
Author: sshnevis

by sshnevisversion 0.1.0i★ 1iRuns on your computer

Registry nameio.github.sshnevis/exiryab-mcp

How to install

What it does

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

Connects Runs on your computer
Account or key No key needed
Category Travel, maps & weather

Install

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

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 13, 2026

First: which AI do you use?

ClaudeWeb · app · phoneChatGPTWebClaude CodeTerminalCursorCode editorVS CodeCode editorOtherOther apps

Pick your app and the steps appear below.

Works with Claude, with some setup first

You need a ExirYab key (create it on the maker’s site) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Install Python (uv)
One time only; it works for every server that needs Python (uv)
Open the Python (uv) download page ↗
Done
Sign up and create a ExirYab key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Open the ExirYab site ↗
Done
Open the Claude desktop app’s settings file
SettingsDeveloperEdit Config
Done

Paste these settings and save the file

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

Paste the key only into the app’s field, never into a chat or to anyone

Done

Quit Claude and open it again
Done
Try it
Use ExirYab and tell me what you can do for me, then show me one thing
✓ If Claude says it is using ExirYab or shows a ExirYab tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect ExirYab yet

ExirYab runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect ExirYab

Steps for Claude →You need a ExirYab key (create it on the maker’s site) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Steps for Claude Code →You need a ExirYab key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
Steps for Cursor →You need a ExirYab key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
Steps for VS Code →You need a ExirYab key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

B · Others in Travel, maps & weather that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Mapbox MCP✓ ChatGPT
LetsFG — Flights & Hotels✓ ChatGPT
Search1API✓ ChatGPT

Works with Claude Code, with some setup first

You need a ExirYab key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

Install Python (uv)
One time only; it works for every server that needs Python (uv)
Open the Python (uv) download page ↗
Done
Sign up and create a ExirYab key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Open the ExirYab site ↗
Done
Open Terminal
Mac: press Command+Space and type Terminal · Windows: open PowerShell
Done
4
Paste this command and press Enter
```
claude mcp add --scope user exiryab --env EXIRYAB_MCP_PROXY=your-value --env EXIRYAB_MCP_BASE_URL=your-value -- uvx exiryab-mcp
```
Replace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
Done
Type /mcp in Claude Code
You should see ExirYab listed as connected
Done
Try it
Use ExirYab and tell me what you can do for me, then show me one thing
✓ If Claude Code says it is using ExirYab or shows a ExirYab tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

You need a ExirYab key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

Install Python (uv)
One time only; it works for every server that needs Python (uv)
Open the Python (uv) download page ↗
Done
Sign up and create a ExirYab key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Open the ExirYab site ↗
Done
Click this button to open Cursor
Open in Cursor
Cursor asks you to confirm; click Install
Done
Fill in your key
In the ExirYab settings, EXIRYAB_MCP_PROXY, EXIRYAB_MCP_BASE_URL is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Done
Open the AI chat in Cursor in Agent mode
Done
Try it
Use ExirYab and tell me what you can do for me, then show me one thing
✓ If Cursor says it is using ExirYab or shows a ExirYab tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

You need a ExirYab key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

Install Python (uv)
One time only; it works for every server that needs Python (uv)
Open the Python (uv) download page ↗
Done
Sign up and create a ExirYab key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Open the ExirYab site ↗
Done
Click this button to open VS Code
Open in VS Code
VS Code asks you to confirm; click Install
Done
Fill in your key
In the ExirYab settings, EXIRYAB_MCP_PROXY, EXIRYAB_MCP_BASE_URL is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Done
Open the AI chat in VS Code in Agent mode
Done
Try it
Use ExirYab and tell me what you can do for me, then show me one thing
✓ If VS Code says it is using ExirYab or shows a ExirYab tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use ExirYab💬 Discussion →

For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

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

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

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

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.

At a glance

GitHub stars i: 1
Downloads per weeki: 44/wk
Licence i: MIT
Connection: Runs on your computer
Transport: stdio
Latest versioni: 0.1.0
Categoryi: Travel, maps & weather
Published to registryi: Oct 14, 2026
Code last changedi: Nov 2, 2026
Maker: sshnevis
Packages: pypi: exiryab-mcp
Repo: sshnevis/exiryab-mcp
Website: exiryab.com
Registry status: Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

All apps, with pros and cons →

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 14, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account sshnevis, which owns the repo
✓ Pass
Still maintained
Code last changed 12 days ago
✓ Pass
Has a licence
Uses MIT
– 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

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

User reviews

No reviews yet

Compared with others in Travel, maps & weatheri

More stars than 88% of the other 1881 servers in this category
Published to the registry more recently than 48% of the other 1881 servers in this category
Basic checks equal to or better than 100% of the other 1881 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 3 of 3 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 12 days ago, and the latest version (0.1.0) reached the registry 31 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: LetsFG — Flights & Hotels, Google Maps MCP Server, Mu

Others in the same category

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

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

LetsFG — Flights & Hotels

Search and book flights and hotels: hundreds of airlines, plus bookable hotel rates.

by LetsFGWidely used↓ 204/wk★ 2.3KUpdated 2 months ago

Computer or cloud

Install

Google Maps MCP Server

18 Google Maps tools for AI agents — geocode, search, directions, weather, and more.

by cablateGrowing↓ 1.3K/wk★ 497Updated 2 months ago

Runs on your computer

Install

Mu

News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.

by microGrowing★ 439Updated 3 months ago

Runs in the cloud✓ micro.mu

How to connect

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

What it does

Install

Install Python (uv)

Sign up and create a ExirYab key

Open the Claude desktop app’s settings file

Paste these settings and save the file

Quit Claude and open it again

Try it

What you can do instead

Install Python (uv)

Sign up and create a ExirYab key

Open Terminal

Paste this command and press Enter

Type /mcp in Claude Code

Try it

Install Python (uv)

Sign up and create a ExirYab key

Click this button to open Cursor

Fill in your key

Open the AI chat in Cursor in Agent mode

Try it

Install Python (uv)

Sign up and create a ExirYab key

Click this button to open VS Code

Fill in your key

Open the AI chat in VS Code in Agent mode

Try it

Installed on your computer

Values you fill in

At a glance

Which apps can use it

Related guides

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

Discussion

User reviews

Compared with others in Travel, maps & weatheri

Common questions

Others in the same category

LetsFG — Flights & Hotels

Google Maps MCP Server

Mu

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