Skip to content
MCP server

ExirYab

Find Iranian doctors by name, city and specialty with clinics and maps

Runs locallyStatus and history
Pricing
Open source
Platforms
self-hosted, CLI, API
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About ExirYab

ExirYab is an open-source MCP server for health and science. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add exiryab-mcp -- uvx exiryab-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "exiryab-mcp": {
      "command": "uvx",
      "args": [
        "exiryab-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "exiryab-mcp": {
      "command": "uvx",
      "args": [
        "exiryab-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

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

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Prices change. Check exiryab.com before you buy.

ExirYab 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 to ExirYab

  1. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  2. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  3. Tutu eSIM

    MCP server

    Live travel eSIM plans, prices and roaming costs for 190+ countries

    • 5 tools
    • Remote
    • Paid
    • Maps and travel
  4. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  5. Curated places, walking routes and areas in Shanghai, Jiangsu and Zhejiang

    • 9 tools
    • Remote
    • Free
    • Maps and travel
  6. Read-only local index of medical-device standards with official links, no standard text

    Runs locally
    • 4 tools
    • Free
    • Legal and government