Skip to main content
khodro45-mcp: unofficial Khodro45 (خودرو۴۵) MCP server that estimates used-car prices, searches inspected cars for sale and reads inspection reports for Claude, Cursor and Copilot

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.

PyPI Python CI License: PolyForm Noncommercial

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-mcp or claude 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_deals for 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_toman is the final price the page shows and car_price_toman the 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 city cannot filter those. Fuel type and seat colour are numeric codes with no public legend and are not exposed.
  • The overall "health score" in k45_inspection is 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.

فارسی

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)

استفادهٔ شخصی و غیرتجاری رایگان است؛ برای استفادهٔ تجاری با سپهر رادمرد تماس بگیرید. Free for personal and non-commercial use; commercial use needs a 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.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for khodro45-mcp 0.1.1
File Size Uploaded Provenance Actions
khodro45_mcp-0.1.1.tar.gz 799.4 kB With provenance Details for khodro45_mcp-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for khodro45-mcp 0.1.1
File Interpreter ABI Platform Actions
khodro45_mcp-0.1.1-py3-none-any.whl Python 3 none any Details for khodro45_mcp-0.1.1-py3-none-any.whl

Total release size: 819.4 kB

Release files / khodro45_mcp-0.1.1.tar.gz

Download URL khodro45_mcp-0.1.1.tar.gz
Size 799.4 kB
Tags Source
SHA-256 checksum
How to use checksums
67df6ee19c7a3315a4d1d3388863131d39153774e639a364f2327f60d2149918
BLAKE2b-256 checksum
How to use checksums
a0b8baa240f670b39b0dc1732e9f6a9a207ac4e85b25e96f8e97922fbad5a33c
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 log

Release files / khodro45_mcp-0.1.1-py3-none-any.whl

Download URL khodro45_mcp-0.1.1-py3-none-any.whl
Size 20.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1ead36f0b42a78d23a718e201ff3468f7484d573d67d14864037d2382c919cc8
BLAKE2b-256 checksum
How to use checksums
30677df5b67d642a4b8bfdda260f45fc80656f71b67ba03fb42219487699127c
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 log

Security for khodro45-mcp 0.1.1

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.

Select from 2 files

Attestation for khodro45_mcp-0.1.1.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 log

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

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page