bama-ir-mcp: Bama (باما) Iran car marketplace MCP server for AI agents
bama-ir-mcp is an unofficial, read-only MCP server that gives AI agents the car ads and price lists of Bama (bama.ir), Iran's car marketplace.
Its 12 tools search used and new car, motorcycle and truck ads with real filters, read one ad in full, compute asking-price statistics for a model, search and rank the new-car price list, show the daily market mood, return technical specs and expert ratings, browse a dealer's inventory and look up brand, model and filter values.
No API key or Bama account is needed. It works in Claude, Cursor, Copilot and any other MCP client.
For AI agents · Quick start · Tools · FAQ
For AI agents
- What: unofficial MCP server (model context protocol) for bama.ir: car ad search (brand/model/trim, year, price, mileage, city, seller, gearbox, body, fuel, color, paint condition, installment), ad details, market price statistics per model and year, new-car price list with trend, dealers and their inventory, motorcycle and truck ads, technical specs and ratings, market pulse.
- Install:
uvx bama-ir-mcporclaude mcp add bama -- uvx bama-ir-mcp. Transport: stdio. Needs uv (Python 3.10+). - Auth: none. Optional
BAMA_MCP_PROXY(HTTP proxy URL, or a comma-separated list); system proxy settings are ignored. - Access: read-only. It cannot log in, post ads, message sellers or read phone numbers.
- Tools: 12, all prefixed
ba_. Typical sequences:ba_vehicles->ba_search->ba_ad;ba_vehicles->ba_market_stats;ba_new_prices/ba_price_list;ba_car_specs;ba_dealers->ba_dealer_ads;ba_filters->ba_search. - Use when: the user asks what a used or new car costs in Iran, wants listings by model, year, mileage or city, wants to compare asking prices, or needs a dealer.
- Do not use when: a car outside Iran, or actual sale prices (these are asking prices).
- Output: compact JSON. Prices are Toman, years Jalali (imports may show Gregorian), mileage km, text Persian.
Quick start
claude mcp add bama -- uvx bama-ir-mcp
Other clients: command uvx, args ["bama-ir-mcp"].
Tools
| Tool | What it does |
|---|---|
ba_search |
Car ads with filters, 30 per page, sortable. |
ba_ad |
One car, motorcycle or truck ad in full, with the real number of ads for that model; optional similar ads. |
ba_market_stats |
Min, quartiles, median, max asking price for a model, per year, from live ads. |
ba_new_prices |
Today's price of new-car trims (market, factory, dealer) with daily change and trend. |
ba_dealers |
Showrooms with ads for a model or city, with address and rating. |
ba_search_bikes_trucks |
Motorcycle or truck ads with filters (brand, year, price, city, body, usage...). |
ba_dealer_ads |
One dealer's inventory (up to 100 ads) with filters and sorting. |
ba_price_list |
Search and rank the daily new-car or motorcycle price list by brand, price type, origin. |
ba_market_pulse |
Today's market score and analysis plus the biggest new-car price movers. |
ba_car_specs |
Technical specs, expert rating, pros and cons, trims of a car or motorcycle model. |
ba_vehicles |
Brand, model and trim values for the other tools (cars, motorcycles, trucks). |
ba_filters |
Values for region, body, fuel, color, country, truck usage and other filters. |
FAQ
Does it need the internet from Iran? Bama answers from inside Iran and through most proxies. Set BAMA_MCP_PROXY to route through one.
Why a sample, not a total? Bama gives no result count and 30 ads per page; ba_market_stats samples up to 5 pages and says so.
Is it allowed? It calls the same public JSON the website uses, serially and with caching. It does not bypass any browser check.
Author: Sepehr Radmard (سپهر رادمرد), github.com/sepehr071, linkedin.com/in/sepehr-radmard. MIT licensed. Not affiliated with Bama.
1 maintainer
Metadata
1 maintainer
Release files for bama-ir-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 |
|---|---|---|---|---|
| bama_ir_mcp-0.1.0.tar.gz | 123.8 kB | With provenance | Details for bama_ir_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| bama_ir_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for bama_ir_mcp-0.1.0-py3-none-any.whl |
Total release size: 148.4 kB
Release files / bama_ir_mcp-0.1.0.tar.gz
| Download URL | bama_ir_mcp-0.1.0.tar.gz |
|---|---|
| Size | 123.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
26a816583ddf5df1c8985e1f8808404f6f2d7975623779b4cba36f892020da4f
|
|
BLAKE2b-256 checksum How to use checksums |
10ba79dfb59e07bb067da66e990297f625230473c23885554deedab5efdc5dbb
|
| 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 / bama_ir_mcp-0.1.0-py3-none-any.whl
| Download URL | bama_ir_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 24.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b84912ccd0a32ae1cba2422254fc417b49a771a95ff69b6fffeb36d933613978
|
|
BLAKE2b-256 checksum How to use checksums |
c73ad4049b80b1524d8e6286c4af6f477c9bae694f4e88b18ab7cb8a3f08ea18
|
| 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 bama-ir-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 bama_ir_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.
