Skip to main content
Glama

doctoreto-mcp: Doctoreto MCP server for AI agents

Let your AI agent find the right Iranian doctor on Doctoreto (دکترتو). An unofficial, read-only MCP server for Doctoreto, the Iranian doctor appointment and online consultation site: search doctors by speciality, city and visit type, compare visit fees, see free appointment times, read reviews, and find hospitals, labs and clinic offers, from Claude, Cursor or Copilot.

PyPI Python CI MCP Registry License: MIT mcpfarsi

Install in Cursor Install in VS Code

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


For AI agents

  • What: unofficial MCP server (model context protocol) for Doctoreto (دکترتو, doctoreto.com), the Iranian doctor appointment and online consultation site. Queries work in Persian or English; prices are in Toman.

  • Install: uvx doctoreto-mcp or claude mcp add doctoreto -- uvx doctoreto-mcp. Transport: stdio. Needs uv (Python 3.10+).

  • Auth: none, no API key or account. Optional DOCTORETO_MCP_PROXY (HTTP proxy URL, or a comma-separated list tried one at a time); system proxy settings are ignored.

  • Access: read-only. It cannot log in, book, pay or post a review, so no confirmation is needed before calling any tool. 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, text, video), see free appointment times, or look up centers, labs and 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, Jalali given next to them), 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.

  • Privacy: no phone numbers and no reviewer names are returned.

  • Machine-readable: server.json and the iran-mcp catalog (TOOLS.md, servers.json, llms.txt).

Related MCP server: paziresh24-mcp

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.

Every reply is compact JSON with empty values left out, so it does not flood the agent's context.

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

Example prompts:

  • "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?"

  • "Compare the phone consultation prices of cardiologists in Isfahan who accept Tamin Ejtemaei insurance."

  • یک متخصص گوش و حلق و بینی در محدوده سعادت‌آباد با بیمه تامین اجتماعی

  • نزدیک‌ترین نوبت خالی متخصص زنان در شیراز و هزینه ویزیت او چقدر است؟

  • آزمایشگاه‌های شبانه‌روزی در تهران را پیدا کن.

Quick start

You need uv. No API key or account.

claude mcp add doctoreto -- uvx doctoreto-mcp

Settings → Developer → Edit Config, then add:

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

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

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

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

Or in ~/.codex/config.toml:

[mcp_servers.doctoreto]
command = "uvx"
args = ["doctoreto-mcp"]

Add to ~/.gemini/settings.json:

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

Add the Claude Desktop block to ~/.codeium/windsurf/mcp_config.json.

It's a standard stdio MCP server: run uvx doctoreto-mcp, or pip install doctoreto-mcp and run doctoreto-mcp.

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.

Tool

What it does

dt_suggest

Free phrase → matching doctors, speciality slugs, service tags and centers

dt_search_doctors

Doctors by city, speciality, neighborhood, name, gender, insurance, visit type, free slot; sorting

dt_specialities

Speciality list with the slugs the search needs

dt_cities

City slug and id; cities that have a speciality, with doctor counts

dt_neighborhoods

Neighborhoods of a city and nearby cities, with doctor counts

dt_insurances

Basic and supplementary insurers with their ids

Tool

What it does

dt_doctor

Profile, every office and online service with fee, deposit, address and next free time, review summary

dt_free_slots

Free appointment times per day for one service (office, phone, video, offer, lab), up to 31 days

dt_reviews

Reviews of a doctor, center or offer: stars, text, labels, waiting time, replies (no names)

Tool

What it does

dt_search_centers

Hospitals, clinics, labs, imaging, pharmacies by city, type, 24h, state/private, or near a point

dt_center

One center: hours, departments, insurances, lab rules, bookable services, doctors

Tool

What it does

dt_search_offers

Fixed-price procedures and packages by text, city, speciality, price range, doctor or place

dt_offer

One offer: price, deposit, provider, terms, variants with their free times

dt_health_articles

Doctoreto health magazine articles on a condition, test or treatment

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

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. Requests use a Chrome-like TLS fingerprint and headers, go out at most 2 at a time with a short random pause, and retry twice on timeouts, 5xx and 429. Only GET requests are ever made.

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 missing fee means the doctor lists none (null and empty values are left out of results; false and 0 are kept).

  • 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. dt_search_offers and the non-map dt_search_centers cut the site's page (about 40 / 20 items) to limit and report on_page.

  • Lists: dt_specialities and dt_insurances return up to limit entries (defaults cover the whole list) plus total, and are cached for an hour together with dt_cities. Long review, about, description and terms texts are cut (400 to 800 characters); full_text=true on dt_doctor, dt_reviews, dt_center and dt_offer returns them whole.

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

  • What it does not do: no login, booking, payment, reviews or chat, and no medical advice. Please keep request rates reasonable.

  • 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

This unofficial MCP server wraps the public endpoints the Doctoreto website itself uses, so Claude, Cursor or Copilot can search doctors, compare visit fees and read free times.

Add the server with claude mcp add doctoreto -- uvx doctoreto-mcp (or use the Cursor and VS Code buttons above, or the config for your client in Quick start), then ask in Persian or English, for example "a cardiologist in Pasdaran, Tehran, as soon as possible".

It is unofficial, open source (MIT) and free. It is read-only, needs no account or API key, and runs on your machine without sending data to any other server.

No, and that's deliberate. It has no login and never calls the booking, payment, review or chat endpoints. The agent finds the doctor, the service and a free time; you book on doctoreto.com with your own phone number.

Doctoreto's API needs the 6-character id, not the name slug. Paste the whole page URL (https://doctoreto.com/doctor/<slug>/<id>), or let the agent search by the doctor's Persian name.

No geo block was seen: direct calls and calls through a proxy in Turkey both worked (2026-10-06). Cloud servers were not tested; if Doctoreto blocks one, set DOCTORETO_MCP_PROXY.

The filters may be too narrow (an insurance plus a neighborhood often is). Drop a filter, or check the slugs with dt_suggest, dt_specialities or dt_neighborhoods. An unknown city or speciality slug returns an error.

The site's search list and doctor profile show a phone consultation price three times the one on the booking page. dt_doctor reads the booking box, so its prices match what you pay.

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

npx @modelcontextprotocol/inspector uvx doctoreto-mcp

Configuration

Variable

Default

Meaning

DOCTORETO_MCP_PROXY

unset

Optional HTTP proxy URL for every request, e.g. http://user:pass@host:port; system proxy settings are ignored. A comma-separated list is used one at a time: the next proxy takes over when one is blocked or cannot connect

If Doctoreto ever serves a bot-check page, install doctoreto-mcp[browser] and run patchright install chromium; a headless browser then clears it once and the cookies are reused.

فارسی: سرور MCP دکترتو (نوبت&zwnj;دهی پزشک)

doctoreto-mcp یک سرور MCP غیررسمی برای دکترتو (سایت نوبت&zwnj;دهی اینترنتی پزشک و مشاوره آنلاین) است که به دستیار هوش مصنوعی شما (Claude، Cursor، Copilot و ...) اجازه می&zwnj;دهد در میان پزشکان ایران، پزشک مناسب را بر اساس تخصص، شهر، محله، بیمه و نوع ویزیت (حضوری، تلفنی، متنی، تصویری) پیدا کند، هزینه ویزیت و زمان&zwnj;های خالی نوبت را ببیند، نظرات بیماران را بخواند و بیمارستان، آزمایشگاه و خدمات دکترتو کلینیک را هم جست&zwnj;وجو کند.

چه کارهایی می&zwnj;کند

  • جستجوی پزشک بر اساس تخصص، شهر، محله، نام، جنسیت، بیمه و نوع ویزیت، با مرتب&zwnj;سازی بر اساس نزدیک&zwnj;ترین نوبت.

  • هزینه ویزیت حضوری (حتی وقتی سایت آن را نشان نمی&zwnj;دهد) و قیمت مشاوره تلفنی، متنی و تصویری.

  • نوبت خالی هر پزشک یا خدمت، تا یک ماه جلوتر.

  • نظرات بیماران: امتیاز، درصد توصیه، زمان انتظار (بدون نام نظردهنده).

  • مراکز درمانی: بیمارستان، کلینیک، آزمایشگاه، مرکز تصویربرداری و داروخانه (از جمله شبانه&zwnj;روزی)، با ساعت کاری و بیمه&zwnj;های پذیرفته&zwnj;شده.

  • خدمات دکترتو کلینیک با قیمت ثابت (سونوگرافی، اکو، لیزر، چک&zwnj;آپ) و مجله سلامت.

نکته&zwnj;ها

  • فقط خواندنی است: وارد حساب نمی&zwnj;شود، نوبت رزرو نمی&zwnj;کند و پرداخت نمی&zwnj;کند؛ لینک صفحه پزشک را برای رزرو می&zwnj;دهد. توصیه پزشکی نیست.

  • همه قیمت&zwnj;ها به تومان است. تاریخ&zwnj;ها میلادی هستند و کنارشان تاریخ شمسی هم آمده؛ ساعت&zwnj;ها به وقت تهران است.

  • شماره تلفن و نام نظردهندگان را برنمی&zwnj;گرداند.

  • کلید API لازم نیست و روی سیستم خود شما اجرا می&zwnj;شود و به هیچ سرور واسطی داده نمی&zwnj;فرستد.

نصب (اول uv را نصب کنید). در Claude Code:

claude mcp add doctoreto -- uvx doctoreto-mcp

در Claude Desktop، Cursor و بقیه برنامه&zwnj;ها همان تنظیم بخش Quick start را بگذارید.

نمونه پرسش&zwnj;ها

  • «یک متخصص قلب در پاسداران تهران با نزدیک&zwnj;ترین نوبت خالی، با هزینه ویزیت»

  • «متخصص گوش و حلق و بینی در سعادت&zwnj;آباد با بیمه تامین اجتماعی»

  • «ویزیت تصویری کدام متخصص کودکان امروز نوبت دارد و قیمتش چقدر است؟»

Development

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

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.

Disclaimer

Unofficial and not affiliated with or endorsed by Doctoreto. It is read-only and 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.

Author

Built and maintained by Sepehr Radmard (سپهر رادمرد). Connect on LinkedIn or follow @sepehr071 on GitHub for more MCP servers for Iranian websites, all listed in iran-mcp. If this saves you time, a star on the repo helps other people find it.

License

MIT

Available Tools

14 tools
dt_centerCenter detailsA
Read-onlyIdempotent

A center's page: address, departments, services, insurances, hours, lab rules, bookable services with consultation_id (for dt_free_slots) and its doctors (hash ids, earliest free slot).

Doctor private offices have no center page: use dt_doctor. Next: dt_free_slots, dt_doctor.

Inputs: center (required), doctors, full_text.

dt_citiesCitiesA
Read-onlyIdempotent

Find a city's slug (for search filters) and numeric id (for dt_suggest); main cities first.

With speciality only main cities are listed. Next: dt_search_doctors(city=slug), dt_neighborhoods.

Inputs: limit, query, speciality.

dt_doctorDoctor profileA
Read-onlyIdempotent

A doctor's profile with every bookable service, its price in Toman and its next free time.

services[] lists each office and online visit with consultation_id (for dt_free_slots), fee, pay_online_now, address and next_free. Also review summary, about text and treated conditions. Next: dt_free_slots, dt_reviews.

Inputs: doctor (required), full_text.

dt_free_slotsFree appointment slotsA
Read-onlyIdempotent

Free appointment times of one service (office visit, phone/video call, clinic offer, lab admission).

Returns only days with free times (HH:MM, Tehran local). bookable_until is the last day opened. Text consultations usually have no slots.

Inputs: consultation_id (required), days, start_date.

dt_health_articlesHealth articlesA
Read-onlyIdempotent

Search Doctoreto's health magazine for background on a condition, test or treatment.

Returns title, link, date and summary; set text_chars to read the articles. Not medical advice.

Inputs: query (required), limit, text_chars.

dt_insurancesInsurancesA
Read-onlyIdempotent

List basic and supplementary insurers with the ids dt_search_doctors(insurance_ids=...) takes.

total counts all matches. Few doctors list insurances, so the filter narrows a lot.

Inputs: limit, query.

dt_neighborhoodsNeighborhoodsA
Read-onlyIdempotent

Neighborhoods of a city (most doctors first) and nearby cities, each with a doctor count.

Next: dt_search_doctors(city, neighborhood=slug).

Inputs: city (required), limit, query, speciality.

dt_offerClinic offer detailsA
Read-onlyIdempotent

One clinic offer in full: price, deposit, doctor, place, terms and bookable variants with consultation_id.

Inputs: offer (required), full_text.

dt_reviewsReviewsA
Read-onlyIdempotent

Patient reviews (doctors and centers newest first, offers oldest first): stars 1-5, text, date and reply.

No sort or filter upstream: page through to find low ratings. The summary is in dt_doctor.

Inputs: id (required), of (required), page, limit, +1 more.

dt_search_centersSearch centersA
Read-onlyIdempotent

Find hospitals, clinics, infirmaries, laboratories, imaging centers and pharmacies with filters.

Cards have the hash id for dt_center. With near_lat/near_lon: a square around the point sorted by distance (dense areas return part of the centers, the rest counted in more_in_area). Otherwise limit cuts the upstream page (on_page). Next: dt_center, dt_reviews(of='center').

Inputs: city, name, page, type, +10 more.

dt_search_doctorsSearch doctorsA
Read-onlyIdempotent

Search doctors by city, speciality, neighborhood, service tag, name, gender, insurance and visit type.

Cards have the hash id for dt_doctor; online prices only in dt_doctor. Next: dt_doctor -> dt_free_slots.

Inputs: city, name, page, sort, +10 more.

dt_search_offersSearch clinic offersA
Read-onlyIdempotent

Search clinic offers: fixed-price procedures and packages (ultrasound, laser, dental, check-ups).

Cards give price and discounted price (Toman), pay_online (deposit if payment is deposit_online) and consultation_id for dt_free_slots. No sort. limit cuts the upstream page (on_page). Next: dt_offer, dt_free_slots.

Inputs: city, page, limit, query, +7 more.

dt_specialitiesSpecialitiesA
Read-onlyIdempotent

List specialities with the slug dt_search_doctors needs; total counts all matches.

parent is the broader speciality. Prefer query. Next: dt_search_doctors(speciality=slug).

Inputs: limit, query.

dt_suggestSuggest doctors, specialities and centersA
Read-onlyIdempotent

Search-box suggestions: doctors (hash id), speciality slugs, service tags and centers for a free phrase.

Doctors match by name; for a speciality use its slug. Next: dt_search_doctors, dt_doctor, dt_center.

Inputs: query (required), limit, city_id.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 14 tools

    Disambiguation5/5

    Each tool has a clearly distinct role: search-card tools are separated from detail-page tools, and lookup tools for cities, specialities, neighborhoods, and insurances are narrowly scoped. The only possible overlap, dt_suggest versus the search tools, is clearly explained as autocomplete/suggestion rather than full search.

    Naming Consistency5/5

    All tools use a consistent dt_ prefix and snake_case. Search operations follow dt_search_<resource>, singular detail pages use dt_<resource>, and plural list/lookup tools are predictably named.

    Tool Count5/5

    Fourteen tools is appropriate for a rich medical-directory domain with doctors, centers, offers, reviews, slots, articles, and multiple filter lookups. Each tool appears to earn its place without excessive redundancy.

    Completeness4/5

    The tool set covers discovery and detail workflows for doctors, centers, offers, reviews, free slots, and health articles, plus the filter lookups needed to search effectively. The main gap is that free slots are exposed but there is no explicit booking/reservation or user-account operation, which may be out of scope but leaves the appointment lifecycle incomplete.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search Snappfood restaurants and SnappMarket stores across Iran, compare true order costs including packaging and delivery, read menus, minimum orders, ETAs and reviews, and surface live flash deals. All operations are read-only, with no login, basket, ordering or payment access.
      8
      21
      319 PyPI
      40
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search Iranian doctors, hospitals and clinics by specialty, city, name, gender and online visit, then read profiles, ratings, insurances, patient reviews, visit prices in Toman and free appointment times. Read-only, with no login, booking or payment, so users compare options and get a profile link to book themselves.
      12
      182 PyPI
      4
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search a directory of Iranian doctors by full or partial name, city or province, and specialty, and returns the best match with alternatives plus clinic addresses, phones, weekly hours, and map links. It is read-only and requires no authentication, so it cannot book appointments or provide medical advice.
      3
      46 PyPI
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search Iranian places, read place details, reviews, photos and menus, find nearby places, reverse geocode coordinates, check air quality, and get car, motorcycle, bicycle, walking or bus/metro directions, travel times and Tehran traffic-zone status without an API key.
      11
      144 PyPI
      MIT