khodro45-mcp: Khodro45 (خودرو۴۵) Iranian used-car marketplace MCP server for AI agents
khodro45-mcp is an unofficial, read-only MCP server that lets an AI agent estimate used-car prices, search inspected cars for sale, read listings and inspection reports, and see real sale prices on Khodro45 (خودرو۴۵, khodro45.com), an Iranian used-car marketplace.
Its 10 tools list brands, models, trims and years, give the public used-car price estimate, search the cars listed for sale, read one listing in full and its expert inspection report, list recent real sales and show zero-km market prices.
No API key or Khodro45 account is needed; it works in Claude, Cursor, Copilot and any other MCP client.
For AI agents · Quick start · Tools · Limits · فارسی
For AI agents
- What: unofficial MCP server (model context protocol) for khodro45.com: the public used-car price estimate, inspected cars for sale, listing details, inspection reports, recent sales and zero-km market prices.
- Install:
uvx khodro45-mcporclaude mcp add khodro45 -- uvx khodro45-mcp. Transport: stdio. Needs uv (Python 3.10+). - Auth: none. Optional
KHODRO45_MCP_PROXY(HTTP proxy URL, or a comma-separated list); system proxy settings are ignored. - Access: read-only. It cannot log in, book an inspection, sell a car or buy one. Seller names and phone numbers are never returned.
- Tools: 10, all prefixed
k45_. Typical sequences:k45_brands->k45_models->k45_trims->k45_price_estimate;k45_cars->k45_car->k45_inspection;k45_dealsfor what really sold. - Use when: the user asks what a used car is worth, wants to find a used car in an Iranian city under a budget, wants a car's inspection report or defects, or asks what cars recently sold for.
- Output: compact JSON. Prices are Toman, mileage is km, years are Persian (Gregorian for imported cars). Names are Persian with English brand names where the site has them.
Quick start
You need uv. No API key or account.
Claude Code:
claude mcp add khodro45 -- uvx khodro45-mcp
Claude Desktop, Cursor, VS Code and other clients:
{
"mcpServers": {
"khodro45": { "command": "uvx", "args": ["khodro45-mcp"] }
}
}
Example prompts:
- "What is a Samand EF7 1396 with 150,000 km worth?"
- "Find the cheapest Peugeot 207 for sale in Tehran and show me its inspection report."
- "What did used Kia cars really sell for on Khodro45 lately?"
- قیمت پژو ۲۰۷ مدل ۱۴۰۰ در تهران چقدر است؟
- گزارش کارشناسی این خودرو را نشان بده.
Real answer (18 Nov 2026): k45_price_estimate(trim_id=1849, year=1396, km=150000) (Samand EF7) returned a market price of 1,570,000,000 Toman (range 1,511,000,000 to 1,628,000,000) and a Khodro45 offer of about 1,461,000,000 Toman. k45_cars(brand="peugeot", model="207", city="تهران", sort="cheapest") listed 112 cars, the cheapest at 1,818,000,000 Toman.
Tools
| Tool | What it returns |
|---|---|
k45_brands |
Car brands, optionally filtered by name |
k45_models |
The models of one brand |
k45_trims |
The trims of a model and their model years |
k45_price_estimate |
Public used-car price estimate (market range and Khodro45's own price) for a trim, year and mileage |
k45_cities |
The cities with listings |
k45_cars |
Used cars for sale: filter by brand, model, city, price, year, km, gearbox, installments |
k45_car |
One listing in full: price, specs, document and ownership facts, photos |
k45_inspection |
The public expert inspection report: section scores and every found defect |
k45_deals |
Used cars Khodro45 really sold lately, with sale price, km, city and quality |
k45_new_car_prices |
Today's zero-km market, factory and dealer prices of a brand, or the market indexes |
Limits
- The estimate is for a car with no defects (the public form sends none). Khodro45's own offer varies by about 1% between identical calls; the market price is stable.
- Card prices exclude the service fee;
price_tomanis the final price the page shows andcar_price_tomanthe car's own price. The price filters apply to the car price. - Listing pages are cached for a few minutes, so the site can lag the API by a few new listings.
- The city list has 87 cities; a few listings sit in smaller cities outside it, so
citycannot filter those. Fuel type and seat colour are numeric codes with no public legend and are not exposed. - The overall "health score" in
k45_inspectionis computed from the section scores (it is not in the API); it matched the page on the cars checked. - Booking, selling, login and agent contact details are not covered. Khodro45 answered both Iranian and foreign networks in testing; if yours is blocked, set
KHODRO45_MCP_PROXY.
How it works
Khodro45 has no public API documentation. The endpoints were mapped by watching khodro45.com in Chrome, and every tool was then checked in Chrome against the real rendered pages (price wizard, listings, listing pages, inspection reports, cities, brands) on 18 Nov 2026. The server calls those same public endpoints through a Chrome-impersonating HTTP client, with a short cache and at most two requests at a time.
فارسی
khodro45-mcp یک سرور MCP غیررسمی و فقطخواندنی برای خودرو۴۵ (khodro45.com) است. با آن یک عامل هوش مصنوعی میتواند برند، مدل و تیپ خودروها را ببیند، قیمت کارشناسی خودروی کارکرده را بر اساس سال و کارکرد تخمین بزند، خودروهای کارشناسیشدهٔ آگهیشده را جستوجو کند، جزئیات هر آگهی و گزارش کارشناسی آن را بخواند، قیمت فروش واقعی خودروهای اخیر و قیمت بازار خودروی صفر را ببیند. بدون حساب کاربری و کلید API کار میکند. نصب در Claude Code:
claude mcp add khodro45 -- uvx khodro45-mcp
Development
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q # offline tests on recorded fixtures
uv run python -m pytest -m live -q # live calls to khodro45.com
Releases: bump the version in pyproject.toml and server.json, run uv lock, then push a v* tag; GitHub Actions publishes to PyPI.
Disclaimer
Unofficial and not affiliated with or endorsed by Khodro45. It is read-only and uses the public pages and API of khodro45.com, which can change without notice.
Author
Built and maintained by Sepehr Radmard (سپهر رادمرد). LinkedIn · GitHub · more servers in iran-mcp.
مجوز استفاده (License)
استفادهٔ شخصی و غیرتجاری رایگان است. استفاده در شرکت، محصول پولی یا پروژهٔ مشتری به مجوز تجاری نیاز دارد؛ از راه لینکدین یا گیتهاب با سپهر رادمرد تماس بگیرید. متن کامل: PolyForm Noncommercial 1.0.0.
Free for personal and non-commercial use under the PolyForm Noncommercial License 1.0.0. Using it in a company, a paid product or a client project needs a commercial license: contact Sepehr Radmard on LinkedIn or GitHub.
Metadata
Release files for khodro45-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| khodro45_mcp-0.1.0.tar.gz | 799.6 kB | With provenance | Details for khodro45_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| khodro45_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for khodro45_mcp-0.1.0-py3-none-any.whl |
Total release size: 819.8 kB
Release files / khodro45_mcp-0.1.0.tar.gz
| Download URL | khodro45_mcp-0.1.0.tar.gz |
|---|---|
| Size | 799.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e0203f6f8dc88ab07824be661d5c2c444b302cf8a63729abf86c81709b89275f
|
|
BLAKE2b-256 checksum How to use checksums |
ca5e2668e1ea86f6f0e554efcd6bc53c4ddf683a747b27289fb4ae9dabc00a02
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.
Transparency logRelease files / khodro45_mcp-0.1.0-py3-none-any.whl
| Download URL | khodro45_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 20.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d1c58b24d5e881ef5ca3d4d65f52dcb75ae128719a3564d76c32405ea251a7f3
|
|
BLAKE2b-256 checksum How to use checksums |
224a2a8b2790759ad86453d86adaead156f7f8f36af334c16066469e53ee7daa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.
Transparency logSecurity for khodro45-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for khodro45_mcp-0.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.