hamrah-mechanic-mcp: Hamrah Mechanic (همراه مکانیک) car prices and used cars MCP server for AI agents
hamrah-mechanic-mcp is an unofficial, read-only MCP server that gives AI agents the public data of Hamrah Mechanic (hamrah-mechanic.com), an Iranian car services company.
Its 12 tools read the daily car market price list by brand, model, trim and year, give a trim's price range and monthly history,
search used and zero-km cars for sale with filters, read one ad in full, list inspection fees, find showrooms, and read
expert reviews and the Persian magazine.
No API key or account is needed. It works in Claude, Cursor, Copilot and any other MCP client.
For AI agents
- What: unofficial MCP server for hamrah-mechanic.com: daily car price list (قیمت روز خودرو), used car search, ad details, inspection prices, showroom list.
- Install:
uvx hamrah-mechanic-mcporclaude mcp add hamrah-mechanic -- uvx hamrah-mechanic-mcp. Transport: stdio. Needs uv (Python 3.10+). - Auth: none. Optional
HAMRAH_MECHANIC_MCP_PROXY(HTTP proxy URL, or a comma-separated list); system proxy settings are ignored. - Access: read-only. It cannot log in, book, buy or sell, and never returns seller phone numbers, so no confirmation is needed before calling any tool.
- Tools: 12, all prefixed
hm_. Typical sequences:hm_brands->hm_models->hm_prices->hm_price_history;hm_search_cars->hm_car->hm_price_estimate;hm_car->hm_inspection_prices;hm_price_list(budget) ->hm_reviews;hm_articles(specs, comparisons). - Use when: the user asks what a car model costs today in Iran (market price by trim and model year), what used cars of a kind are on sale and for how much, whether an ad is priced fairly, what a car inspection costs, or where the showrooms are.
- Do not use when: the user wants other sellers' marketplaces, factory prices, parts, repair or insurance prices (the site has none), or anything that needs an account.
- Output: compact JSON, prices in Toman, Persian names. Years are Solar Hijri for Iranian cars and Gregorian for imports.
Quick start
claude mcp add hamrah-mechanic -- uvx hamrah-mechanic-mcp
Other clients: command uvx, args ["hamrah-mechanic-mcp"].
Tools
| Tool | What it does |
|---|---|
hm_brands |
Brand slugs, optionally filtered by name. |
hm_models |
Models of a brand with slugs. |
hm_prices |
Daily market prices: a brand's models, a model's trims by year, or one year. |
hm_price_estimate |
Price range and monthly trend of one trim in one year. |
hm_price_history |
About six monthly market prices of one trim and year, plus its other years and cars for sale. |
hm_price_list |
Every priced domestic or imported car, filtered by budget or brand. |
hm_reviews |
Expert review (pros, cons, engine, safety), owner ratings and comments of a model, or a brand profile. |
hm_articles |
Search and read the Persian magazine (specs, comparisons, buying and care advice, news). |
hm_search_cars |
Cars for sale: brand, model, price, year, km, gearbox, fuel, body, origin, color, city, installments, showroom stock, sort. |
hm_car |
One ad: price, specs, condition, highlights, photos. |
hm_inspection_prices |
Fee for the full, VIP and economy inspection of a car, by time slot. |
hm_branches |
Showrooms and inspection centers of a province. |
FAQ
Is it official? No. It reads the same public pages and API that hamrah-mechanic.com shows any visitor, with a small cache and request limit.
Does it work outside Iran? Yes, directly or through HAMRAH_MECHANIC_MCP_PROXY.
فارسی
سرور MCP غیررسمی و فقطخواندنی برای همراه مکانیک: قیمت روز خودرو بر اساس برند، مدل، تیپ و سال، برآورد قیمت، جستوجوی خودروهای آگهیشده با فیلتر، جزئیات آگهی، هزینهٔ کارشناسی و شعب حضوری. نصب: uvx hamrah-mechanic-mcp.
Author: Sepehr Radmard (سپهر رادمرد) · github.com/sepehr071 · linkedin.com/in/sepehr-radmard
1 maintainer
Metadata
1 maintainer
Release files for hamrah-mechanic-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 |
|---|---|---|---|---|
| hamrah_mechanic_mcp-0.1.0.tar.gz | 117.7 kB | With provenance | Details for hamrah_mechanic_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| hamrah_mechanic_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for hamrah_mechanic_mcp-0.1.0-py3-none-any.whl |
Total release size: 140.4 kB
Release files / hamrah_mechanic_mcp-0.1.0.tar.gz
| Download URL | hamrah_mechanic_mcp-0.1.0.tar.gz |
|---|---|
| Size | 117.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
135939caeba5d23fd8860f9ce473188cb132c49eeec6dff6b29996254128dea2
|
|
BLAKE2b-256 checksum How to use checksums |
39b1b5fc061deff11b4d4cf67cc5f4fbebd4dd06c86b902167584da54da0ffa5
|
| 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 1, 2026.
Transparency logRelease files / hamrah_mechanic_mcp-0.1.0-py3-none-any.whl
| Download URL | hamrah_mechanic_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 22.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9395154b3a780a34a120f40d2a02b7358d2ca27799faf6651b1cc6fc041e3230
|
|
BLAKE2b-256 checksum How to use checksums |
e309bb8e5705f7780f7599442eb0c4e986daf6ca2f9957fb4614583aca1c4cd4
|
| 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 1, 2026.
Transparency logSecurity for hamrah-mechanic-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
All 2 files in this release have been uploaded with provenance metadata.
Attestation for hamrah_mechanic_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 1, 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.
