paziresh24-mcp
Unofficial read-only Paziresh24 MCP server that lets AI agents search Iranian doctors, hospitals and clinics and inspect profiles, availability, prices, reviews, holidays and FAQ data.
Search doctors by city, specialty, name, visit type, gender, degree, work time and center, with sorting and paging; also list hospitals and clinics.
Resolve Persian/English words into city and specialty slugs, and Paziresh24 URLs into doctor or center slugs.
Read doctor profiles: specialties, about text, ratings, insurances, online visit channels and prices, centers, services and weekly hours.
Read hospital/clinic profiles: address, phone, website, map, departments and doctors.
Find availability: earliest free appointment, free days across the booking window, and free slots for a date range.
Get exact service prices in Toman, including fee, VAT, payable total and refund-on-cancel setting; check official Iranian holidays.
Read paged patient reviews with rating summaries, and search the official Paziresh24 FAQ about booking, cancellation, online visits and refunds.
It is read-only: no login, booking, slot holding, payment, cancellation, review posting or medical advice; it provides the doctor profile URL for booking.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@paziresh24-mcp find a female cardiologist in Tehran with an online visit today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
paziresh24-mcp: Paziresh24 MCP server for AI agents
Let your AI agent find the right Iranian doctor on Paziresh24 (پذیرش۲۴). An unofficial, read-only MCP server for Paziresh24, Iran's doctor appointment booking site: search doctors by specialty, city, name and online visit, read profiles, prices, insurances and patient reviews, and see free appointment times, from Claude, Cursor or Copilot.
For AI agents · Why · What it can do · Quick start · Tools · How it works · Good to know · FAQ · Configuration · فارسی · Development · Related servers
For AI agents
What: unofficial MCP server (model context protocol) for Paziresh24 (پذیرش۲۴, paziresh24.com), the Iranian doctor appointment site: doctors, hospitals and clinics, in-person and online visits. Queries in Persian or English.
Install:
uvx paziresh24-mcporclaude mcp add paziresh24 -- uvx paziresh24-mcp. Transport: stdio. Needs uv (Python 3.10+).Auth: none, no API key or account. Optional
PAZIRESH24_MCP_PROXYsets an HTTP proxy for every request (a comma-separated list rotates after a block); system proxy settings are ignored.Access: read-only. It cannot log in, hold a slot, book, pay or post a review, so no confirmation is needed before calling any tool. Give the user the doctor's profile
urlto book.Tools: 12, all prefixed
pz_, all annotatedreadOnlyHint: true. Start withpz_suggest(words to city and specialty slugs),pz_search_doctors,pz_doctor,pz_free_slots,pz_visit_price.Typical sequence:
pz_suggest->pz_search_doctors->pz_doctor->pz_first_availableorpz_free_slots->pz_visit_price.Use when: the user wants to find a doctor, compare ratings, insurance and online visit fees, or see free appointment times in Iran.
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 localHH:MM. Doctors are identified by their Persian slug; slot and price tools takecenter_id,user_center_idandservice_idfrompz_doctor(online visits use center5532).Machine-readable: server.json, and the catalog of all Iranian MCP servers iran-mcp (
TOOLS.md,servers.json,llms.txt).
Related MCP server: flytoday-mcp
Why
Paziresh24 (paziresh24.com) is Iran's largest doctor appointment site, listing doctors, hospitals and clinics, with in-person
booking and online visits by phone or messenger. Picking one means comparing specialties, ratings, insurance,
prices and who has a free slot soon. An agent with paziresh24-mcp reads the same data the site shows and does
the comparing for you, then gives you the profile link to book:
You: A female cardiologist in Tehran with an online visit today, not too expensive?
Agent: calls
pz_search_doctors(city="tehran", specialty="cardiovascular", visit_type="online", gender="female", sort="earliest")→pz_doctor(slug="دکتر-هدیه-جباری-0")→pz_free_slots(center_id="5532", ...)→pz_visit_price(center_id="5532", ...)Dr. Hedieh Jabbari (cardiologist, 5.0 from 11 ratings) has online visits over WhatsApp today from 15:00 (10-minute slots: 15:00, 15:10, 15:20, ...). The visit is 500,000 Toman + 15,000 VAT = 515,000 Toman. Book it here: https://www.paziresh24.com/dr/دکتر-هدیه-جباری-0/
Real tool output from 2026-10-06; slots and prices change all the time. Prices are in Toman.
What it can do
Search doctors by city, specialty, name, online visit, gender, degree and work time, sorted by best, nearest free time or cheapest online visit
Resolve words: Persian or English city and specialty names to search slugs, plus the site's type-ahead
Read a profile: specialties, about text, medical council code, offices and hospitals with address, phone and map, services, weekly hours, insurance contracts, online visit channels
Find a time: the earliest free appointment, the days with free slots, and the free times of each day (in person and online)
Know the cost: online visit fee, VAT and the payable total in Toman
Check reviews: rating averages, average waiting time and paged patient reviews (no reviewer names)
Hospitals and clinics: departments, doctors, phone, website, map
Read-only by design: no login, no slot holds, no booking, no payment
Example prompts:
"A dermatologist in Shiraz who accepts Tamin Ejtemaei and has a free slot this week."
"Cheapest online pediatrician visit available today?"
"What do patients say about this doctor? https://www.paziresh24.com/dr/..."
"Which cardiologists work at Treata hospital, and who is free soonest?"
"Is next Thursday an official holiday in Iran, and is this doctor free the day after?"
یک متخصص پوست خانم در تهران که امروز ویزیت آنلاین دارد و گران نیست؟
نزدیک‌ترین نوبت خالی دکتر قلب در شیراز کی است؟
چطور نوبت ویزیت آنلاین را لغو کنم و پولم برمی‌گردد؟
Quick start
You need uv. No API key or account.
claude mcp add paziresh24 -- uvx paziresh24-mcpSettings → Developer → Edit Config, then add:
{
"mcpServers": {
"paziresh24": { "command": "uvx", "args": ["paziresh24-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": {
"paziresh24": { "type": "stdio", "command": "uvx", "args": ["paziresh24-mcp"] }
}
}codex mcp add paziresh24 -- uvx paziresh24-mcpOr in ~/.codex/config.toml:
[mcp_servers.paziresh24]
command = "uvx"
args = ["paziresh24-mcp"]Add to ~/.gemini/settings.json:
{
"mcpServers": {
"paziresh24": { "command": "uvx", "args": ["paziresh24-mcp"] }
}
}Add the Claude Desktop block to ~/.codeium/windsurf/mcp_config.json.
It's a standard stdio MCP server: run uvx paziresh24-mcp, or pip install paziresh24-mcp and run paziresh24-mcp.
Then just ask, in Persian or English, with one of the example prompts above.
Tools
Doctors are identified by their Persian slug, the part after /dr/ in the profile URL
(دکتر-هدیه-جباری-0); slot and price tools take the center_id, user_center_id and service_id
that search results and pz_doctor return.
Tool | What it does |
| Persian or English words → city slugs, specialty slugs and query completions |
| Doctors (or hospitals and clinics) by city, specialty, name, online visit, gender, degree, with sorting and paging |
| A paziresh24.com link → doctor or center slug |
| Hospital or clinic: address, phone, website, departments and doctors |
Tool | What it does |
| Full profile: specialties, about, rating, insurances, online visit, centers, services, prices, weekly hours |
| Earliest free in-person and online slot, per center |
| Patient reviews (paged) with rating averages and waiting time per center |
Tool | What it does |
| Days with free slots over the whole booking window, days off and holidays |
| Free appointment times per day for a date range |
| Fee, VAT and payable total in Toman, and the refund-on-cancel setting |
| Official Iranian holidays between two dates |
Tool | What it does |
| Paziresh24's official FAQ: booking, cancelling, online visits, refunds |
All 12 tools are annotated readOnlyHint: true and return compact JSON in one text block, so they don't flood the agent's context.
How it works
AI agent (Claude, Cursor, Copilot, ...)
│
│ MCP over stdio
▼
paziresh24-mcp (runs on your machine)
│
│ HTTPS (JSON)
├──────▶ apigw.paziresh24.com (search, free days and slots, prices, holidays)
├──────▶ drprofile.paziresh24.com (doctor profiles)
├──────▶ ravi-apis.paziresh24.com (reviews and ratings)
├──────▶ saman / biko.paziresh24.com (availability, insurance)
└──────▶ www.paziresh24.com (cities, specialties, hospitals, FAQ)paziresh24-mcp runs locally and calls the same public endpoints the Paziresh24 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 and header profile, at most 2 at a time with a short random delay, time out after 20 seconds and
are retried up to twice on connect errors, timeouts, 429 and 5xx. Reference data (cities, specialties, FAQ) is
cached for 6 hours. Redirects away from *.paziresh24.com are refused.
Good to know
Prices are in Toman (1 Toman = 10 Rial). The APIs answer in Rial; the server divides by 10.
In-person office visits usually show price 0: they are paid at the office and the fee is not published. Online visits have a real fee;
pz_visit_priceadds the VAT (3% on the checked example).Times are Tehran local (
HH:MM), dates GregorianYYYY-MM-DD(1405-07-18 = 2026-10-10).Online visits live in Paziresh24's virtual center
5532(phone call or messenger such as WhatsApp; seechannels).Search cards carry the doctor's
genderand photo (image, from pic.paziresh24.com; a real photo even where the profile has none).Insurance: search cards list accepted insurance names, but there is no insurance filter. A
pz_doctorresult withoutinsurancesmeans no data, not "no insurance". Empty fields are omitted from all results; review text is clipped to 400 characters (passfull_text=truefor everything; same forpz_doctor,pz_center,pz_faq) and is untrusted site content.Centers with booking off stay in
pz_doctorwithbooking_off: true(call their phone);booking_opensmeans the booking period has ended and new slots open at that time. Search cards give the first free time per center as well as the doctor's earliest overall.Booking is not possible here. Booking needs an SMS login, so the agent gives you the doctor's profile URL. Free slots are listed, never held.
sort="earliest"drops doctors without a free slot. Each page is sorted by the doctor's nearest free slot at any center (not across pages); search results can include sponsored doctors.Limits:
pz_search_doctorsreturns at most 50 results per page. Reviews are paged (1-50 per page, default 5), and reviewer names are never returned.Specialty groups are broad: a group slug such as
ophthalmologyalso includes related professions (for example optometrists); theexp-slug of the same title (exp-ophthalmology) lists only that specialty.pz_suggestreturns both.Holidays:
pz_holidaysdepends on the site's holidays endpoint, which answered HTTP 500 on 2026-10-10; if it fails, retry later.What it does not do: no login, booking, cancelling, payment, chat, bookmarks or posting reviews; no patient data; no medical advice.
Checked against the website: on 2026-10-06 every tool's output was compared with the live paziresh24.com pages (names, prices, first free times, review order, search totals). Free days and slots were compared only where the site shows them without holding a slot.
FAQ
Yes: this unofficial MCP server wraps the public endpoints the Paziresh24 website itself uses, so Claude, Cursor or Copilot can search doctors and read free times and prices.
Add the server with claude mcp add paziresh24 -- uvx paziresh24-mcp (or use the Cursor and VS Code buttons above),
then ask in Persian or English, for example "a cardiologist in Tehran with an online visit today".
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 never calls login, slot-hold, booking, payment or review endpoints (a test fails if their paths appear in the code). The agent finds the doctor and the time; you book on the profile page.
Not in the search: the site's API ignores an insurance filter. Each search card lists the insurance names the doctor
accepts, and pz_doctor returns the insurance contracts, so the agent can check them for you.
No geo block was seen: direct calls and calls through a proxy in Turkey both worked (2026-10-06). If your network
blocks the site, set PAZIRESH24_MCP_PROXY.
Some Paziresh24 gateway routes sometimes hang for 20-30 seconds. The server retries up to twice; if it still fails, try again in a minute.
Install the optional browser fallback (see Configuration). It clears the check once with a headless Chromium; without it the tool reports an error that says so.
Use the full path to uvx (where uvx on Windows, which uvx on macOS/Linux) as command.
npx @modelcontextprotocol/inspector uvx paziresh24-mcpConfiguration
Variable | Default | Meaning |
| unset | HTTP proxy for every request, e.g. |
If the site shows a bot-check page, install the optional browser fallback: pip install "paziresh24-mcp[browser]"
(or uvx --from "paziresh24-mcp[browser]" paziresh24-mcp), then run patchright install chromium.
فارسی: سرور MCP پذیرش۲۴
paziresh24-mcp یک سرور MCP غیررسمی برای پذیرش۲۴ (سامانه نوبت‌دهی آنلاین پزشکان) است که به دستیار هوش مصنوعی شما (Claude، Cursor، Copilot و ...) اجازه می‌دهد در میان پزشکان ایران پزشک پیدا کند: جستجو بر اساس تخصص، شهر، نام و ویزیت آنلاین، خواندن پروفایل، بیمه‌ها، قیمت و نظرات بیماران، و دیدن زمان‌های خالی نوبت.
فقط خواندنی است: وارد حساب نمی‌شود، نوبت نگه نمی‌دارد، نوبت ثبت نمی‌کند و پرداخت نمی‌کند.
برای گرفتن نوبت، لینک صفحه پزشک را به شما می‌دهد.
همه قیمت‌ها به تومان است.
۱۲ ابزار دارد که همگی با
pz_شروع می‌شوند.روی سیستم خود شما اجرا می‌شود، کلید API لازم ندارد و به هیچ سرور واسطی داده نمی‌فرستد.
توصیه پزشکی نمی‌کند.
کلمات جستجو: پذیرش۲۴، پذیرش 24، نوبت دهی پزشک، نوبت اینترنتی پزشک، نوبت دکتر، ویزیت آنلاین، مشاوره آنلاین پزشک، پیدا کردن پزشک متخصص، نزدیک‌ترین نوبت خالی، هزینه ویزیت، نظرات بیماران، بیمه تامین اجتماعی، سرور MCP، هوش مصنوعی.
نصب در Claude Code (اول uv را نصب کنید):
claude mcp add paziresh24 -- uvx paziresh24-mcpدر Claude Desktop، Cursor و بقیه برنامه‌ها همان تنظیم بخش Quick start را بگذارید.
بعد بپرسید: «یک متخصص پوست خانم در تهران که امروز ویزیت آنلاین دارد و گران نیست؟»
Development
git clone https://github.com/sepehr071/paziresh24-mcp && cd paziresh24-mcp
uv sync
uv run python -m pytest # offline, against recorded responses
uv run python -m pytest -m live # real APIs
uv run ruff check .Tools live in src/paziresh24_mcp/search.py, doctor.py, slots.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
iran-mcp: catalog of all Iranian-service MCP servers
doctoreto-mcp for doctor visit fees, free times, clinics and labs
jabama-mcp for Jabama stays
mrbilit-mcp for Mrbilit travel tickets
flytoday-mcp for Flytoday flights
Listed on mcpfarsi.ir, the Persian MCP marketplace
Disclaimer
Unofficial and not affiliated with or endorsed by Paziresh24. It is read-only and uses the public endpoints of the paziresh24.com website, which can change without notice. It is 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
Available Tools
12 toolspz_centerHospital or clinic profileARead-onlyIdempotent
Profile of a hospital or clinic: type, address, phone, website, map, about, departments and its doctors (slug, department, specialty, basic insurances).
For its doctors by nearest free time: pz_search_doctors(center_id=..., sort='earliest').
Inputs: slug (required), full_text, specialty, doctors_limit.
pz_doctorDoctor profileARead-onlyIdempotent
Full profile of one doctor: specialties, about, rating averages, insurances, online visit (channels, price in Toman) and every center with address, phone, map, first free slot and services (ids, price, duration, hours).
booking_off: true = booking switched off (call the phone); booking_opens = new slots open then.
A service's center_id + user_center_id + service_id feed the slot and price tools.
Inputs: slug (required), full_text.
pz_faqPaziresh24 FAQARead-onlyIdempotent
Answers from the official Paziresh24 FAQ: booking, cancelling or moving, online visits, payment and refunds.
Without a query it lists the questions only. Use for "how do I ..." questions about the site.
Inputs: limit, query, full_text.
pz_first_availableEarliest free appointmentARead-onlyIdempotent
Whether a doctor can be booked now and the nearest free slot, in person, online and per center (Tehran time).
Quick check; names and service ids are in pz_doctor.
Inputs: slug (required).
pz_free_daysFree appointment daysARead-onlyIdempotent
Days with a free appointment for one service at one center over the whole booking window (often 6-8 weeks), with weekly days off and holidays.
Next: pz_free_slots for times.
Inputs: center_id (required), service_id (required), user_center_id (required).
pz_free_slotsFree appointment slotsARead-onlyIdempotent
Free appointment start times (Tehran HH:MM) per day for one service at one center, for a date range.
With no free slot in the range, next_free_day gives the next one.
Inputs: center_id (required), service_id (required), user_center_id (required), date_to, +1 more.
pz_holidaysPublic holidaysARead-onlyIdempotent
Official Iranian public holidays and occasions between two dates (Persian name, Hijri date).
Fridays are not listed.
Inputs: date_to (required), date_from (required).
pz_resolve_urlResolve a Paziresh24 URLARead-onlyIdempotent
Turn a paziresh24.com link into its kind ('doctor' or 'center'), slug and clean URL.
Use when the user pastes a link.
Inputs: url (required).
pz_reviewsDoctor reviewsARead-onlyIdempotent
Patient reviews (stars 1-5, text clipped to 400 chars, visit reason, center, verified visit), paged, plus on the first page a summary: rating averages, counts and waiting time per center.
Reviewer names and ids are never returned.
Inputs: slug (required), sort, limit, offset, +1 more.
pz_search_doctorsSearch doctorsBRead-onlyIdempotent
Search doctors (or hospitals and clinics) by city, specialty, name, visit type, gender and degree, sorted and paged.
Cards carry url, image, rating, insurances, first free slots, online_visit (price in Toman) and slot-tool ids (missing service_id: pz_doctor).
Inputs: city, page, sort, text, +8 more.
pz_suggestSuggest cities, specialties and queriesARead-onlyIdempotent
Turn words into pz_search_doctors arguments: matching cities, specialties (with slugs) and the site's query completions (use one as text).
Call first when you lack the city or specialty slug. Next: pz_search_doctors.
Inputs: query (required), limit.
pz_visit_priceVisit priceARead-onlyIdempotent
Exact price of one service in Toman: fee, VAT and payable total (the online-visit invoice), plus the refund-on-cancel setting.
Office visits usually show 0.
Inputs: center_id (required), service_id (required), user_center_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Most tools map to a single, distinct resource or operation (profile, reviews, price, holidays, FAQ), and the descriptions explicitly cross-reference each other to disambiguate. The only real overlap is availability: pz_first_available, pz_free_days, and pz_free_slots all answer 'when can I get in', though the descriptions scope them as quick-check vs. per-service day/slot detail.
Every tool uses a uniform pz_ snake_case prefix, so scoping is instantly recognizable. Within that, the suffixes mix verb phrases (resolve_url, search_doctors, suggest) with bare nouns (doctor, center, reviews, faq, holidays), which is readable but not a strict verb_noun pattern.
Twelve tools is well within the sweet spot and each one earns its place: search, two profile types, three availability tools with distinct granularity, price, reviews, FAQ, holidays, and two helpers for link parsing and query normalization. No obvious filler.
The discovery-to-decision lifecycle is well covered: resolve link, normalize query, search, inspect doctor/center, check availability, price, and reviews. The main gap is the terminal action — there is no tool to actually create or manage a booking, and no way to list/filter by insurance or online-visit channel, so agents must hand off to the website.
Maintenance
Related MCP Connectors
Search Doctr clinics and read their public profiles and services.
Research 7,400+ US doctors: search, semantic search, profiles, reviews & procedure pricing.
Search a healthcare provider directory and get full provider details by id.
Read appointments, professionals and rooms; book, update and cancel visits in ByDoctor.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI agents to search Iranian doctors by speciality, city, neighborhood, insurance and visit type, compare office and online consultation fees, check free appointment times up to a month ahead, and read reviews. Also covers hospitals, clinics, labs, pharmacies, fixed-price clinic offers and health articles, all read-only so booking happens on the site via a returned link.14171 PyPI2MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to compare and find the cheapest domestic and international flights, hotels, villas, trains and buses in Iran, with exact Toman prices, fare and cancellation rules, baggage details, seats left and hotel reviews. Also covers CIP lounges, eSIM plans, visas and tours, and is read-only, so it never books, holds seats or pays.246 PyPI2MIT
- AlicenseAqualityBmaintenanceEnables 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.346 PyPI1MIT
- AlicenseAqualityBmaintenanceEnables 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.11208 PyPIMIT