Doctoreto

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.

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

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 Code

claude mcp add doctoreto -- uvx doctoreto-mcp

Claude Desktop

Settings → Developer → Edit Config, then add:

{

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

</details>

Cursor

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

VS Code (Copilot agent mode)

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

{

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

</details>

Codex CLI

codex mcp add doctoreto -- uvx doctoreto-mcp

Or in ~/.codex/config.toml:

[mcp_servers.doctoreto]

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

</details>

Gemini CLI

Add to ~/.gemini/settings.json:

{

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

</details>

Windsurf

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

Anything else

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.

Find a doctor (6)

One doctor (3)

Centers (2)

Clinic offers and reading (3)

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 li