🩺 doctoreto-mcp: Doctoreto MCP server for AI agents

Unofficial, read-only MCP server that lets your AI agent find the right Iranian doctor on Doctoreto (دکترتو).
Search Iranian doctors by speciality, city, neighborhood and visit type, compare visit fees,
see free appointment times, read reviews, and find hospitals, labs and clinic offers, all from Claude, Cursor or Copilot.

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

For AI agents

• What: Unofficial MCP server for Doctoreto (دکترتو, doctoreto.com), the Iranian doctor appointment and online consultation site. Queries in Persian or English; prices in Toman.
• Install: claude mcp add doctoreto -- uvx doctoreto-mcp (stdio, needs uv and Python 3.10+).
• Auth: none. Optional DOCTORETO_MCP_PROXY sets an HTTP proxy for every request.
• Access: read-only. It cannot log in, book, pay or post a review; give the user the doctor's page link to book.
• Tools: 14, all prefixed dt_. Start with dt_suggest (free phrase to doctors and slugs), dt_search_doctors, dt_doctor, dt_free_slots; dt_search_centers and dt_search_offers for hospitals, labs and clinic offers.
• Typical sequence: dt_search_doctors -> dt_doctor -> dt_free_slots -> dt_reviews.
• Use when: the user wants to find a doctor in Iran, compare visit fees (office, phone, video) or see free appointment times, centers or fixed-price clinic offers.
• Do not use when: the user wants to actually book or pay, or needs medical advice.
• Output: compact JSON. Prices in Toman, dates Gregorian YYYY-MM-DD, times Tehran local. Doctors, centers and offers use a 6-character id (or the page URL); a name slug alone cannot be resolved. Use dt_doctor for online prices.
• Machine-readable: server.json, and the catalog of all Iranian MCP servers awesome-iran-mcp (TOOLS.md, servers.json, llms.txt).

Why

On Doctoreto (doctoreto.com) a doctor card shows a name and a rating, but the things you decide on are a few clicks deeper: which offices the doctor has, what the visit costs at the office (often hidden on the page), what a phone or video consultation costs, and when the next free time actually is. An agent with doctoreto-mcp reads the search, the doctor's services and the slot picker, and hands you the booking link:

You: A cardiologist in Pasdaran, Tehran, as soon as possible. What does the visit cost?

Agent: calls dt_search_doctors(city="tehran", speciality="cardiologist", neighborhood="pasdaran", has_free_slot=True) → dt_doctor(doctor="xqbEWZ") → dt_free_slots(consultation_id=1943, days=7)

Service	Fee	Paid when booking	Next free
Office visit, Pasdaran	250,000	0	Tue 6 Oct, 10:00 (25 free times that day)
Phone call, 15 minutes	750,000	750,000	Tue 6 Oct, 10:00

دکتر کامبیز پرآذران, subspecialist in cardiology: 408 reviews, 92% recommend, about 36 minutes wait at the office. The office fee is paid at the office. Book here: https://doctoreto.com/doctor/dr-kambiz-parazaran/xqbEWZ

_{Real tool output from 2026-10-06; prices and free times change all the time. Prices are in Toman.}

What it can do

• 🔎 Find doctors by speciality, city, neighborhood, name, gender, insurance and visit type (office, phone, text, video, instant)
• ⏱️ Soonest first: sort by the earliest free slot, by popularity or by number of bookings; search near a point
• 💰 Real prices: office visit fee (also when the site hides it), online consultation prices, deposits
• 📅 Free times: free appointment times per day for any office or online service, up to a month ahead
• ⭐ Reviews: stars, recommend rate, waiting time, per-category averages; reviewer names are never returned
• 🏥 Centers: hospitals, clinics, laboratories, imaging, pharmacies (24h, state/private, map search), hours and insurances
• 🏷️ Clinic offers: fixed-price procedures (ultrasound, echo, laser, check-ups) with deposits and free times
• 📖 Health magazine: background articles on conditions and tests
• 🔒 Read-only by design: no login, no booking, no payment; the agent gives you the link to book

Quick start

You need uv.

claude mcp add doctoreto -- uvx doctoreto-mcp

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

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

Then just ask:

• "A female dermatologist in Shiraz with a free slot this week, and her visit fee?"
• "Which pediatricians offer a video call today, and how much is it?"
• "A 24-hour pharmacy near Vanak Square."
• "How much is an echocardiography at a Doctoreto clinic in Tehran, and when is the next free time?"
• یک متخصص گوش و حلق و بینی در محدوده سعادت‌آباد با بیمه تامین اجتماعی

How it works

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  doctoreto-mcp  (runs on your machine)
      │
      │  HTTPS (JSON)
      ├──────▶  api.doctoreto.com   (doctors, slots, reviews, centers, offers)
      └──────▶  doctoreto.com/blog   (health magazine)

doctoreto-mcp runs locally and calls the same public endpoints the Doctoreto website uses. There's no hosted server in between, no API key, and nothing about you is sent anywhere else.

Tools

Doctors, centers and offers are identified by a 6-character id (xqbEWZ, the last part of doctoreto.com/doctor/dr-kambiz-parazaran/xqbEWZ); every tool also accepts the page URL itself.

All 14 tools are annotated readOnlyHint: true and return compact structured JSON, so they don't flood the agent's context.

Good to know

• Prices are in Toman. For an office visit fee is what you pay at the office and pay_online_now what is charged when booking (usually 0). For phone, text and video fee is the online price. A null fee means the doctor lists none.
• Use dt_doctor for online prices. The search list and the profile show a phone price three times the one on the booking page; dt_doctor reads the booking box, which matches the page.
• Dates are Gregorian YYYY-MM-DD (1405-07-22 = 2026-10-14); times are Tehran local. Jalali dates are given next to them.
• Booking happens on the site. It needs an SMS code, so the agent finds the doctor and time and gives you the page link.
• Insurance: few doctors list insurances, so insurance_ids narrows a search a lot. Centers list theirs in dt_center; the center search ignores insurance filters.
• Reviews: doctor and center reviews come newest first, offer reviews oldest first; each review date is the Tehran day, as on the page.
• Search pages hold exactly limit doctors, also when the site mixes sponsored doctors in.
• Photos and offices: search cards and dt_doctor carry the doctor's photo URL (image). In a search card, earliest_free.place_id matches an offices[].id, so you can tell which office has the first free slot.
• Privacy: no phone numbers and no reviewer names are returned.
• Checked against the website: on 2026-10-06 every tool's output was compared with the live doctoreto.com pages (names, fees, free times per day, review order, search totals and order, centers, offers).

FAQ

npx @modelcontextprotocol/inspector uvx doctoreto-mcp

Configuration

فارسی: سرور MCP دکترتو

claude mcp add doctoreto -- uvx doctoreto-mcp

Development

git clone https://github.com/sepehr071/doctoreto-mcp && cd doctoreto-mcp
uv sync
uv run pytest            # offline, against recorded responses
uv run pytest -m live    # real APIs
uv run ruff check .

Tools live in src/doctoreto_mcp/search.py, doctor.py, centers.py, offers.py and info.py; each is a typed async function with a docstring that tells the agent when to use it. Issues and PRs are welcome, especially new tools and fixes for API changes.

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 for Iranian doctors, profiles and free appointment slots
• All Iranian MCP servers: awesome-iran-mcp

Disclaimer

Unofficial and not affiliated with or endorsed by Doctoreto. It uses the public endpoints of the doctoreto.com website, which can change without notice. It gives information, not medical advice. Please keep request rates reasonable.

If this saves you clicks, a star helps others find it.

License

MIT