Bama Cars

io.github.sepehr071Published by GitHub account sepehr071v0.2.0Updated Nov 7, 2026

Read-only Bama (bama.ir) Iran car marketplace: ad search, ad details, market prices, new-car prices.

VerifiedSTDIODesktop onlyLocation & LifestyleWeb Search & ScrapingFinance

Overview

Bama Cars's local MCP server; no sign-in required; STDIO.

No AI overview yet: these facts come from the registry entry and the server itself.

Installation

In SourceWeft

  1. Open Bama Cars in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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-mcp or claude 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

bash
claude mcp add bama -- uvx bama-ir-mcp

Other clients: command uvx, args ["bama-ir-mcp"].

Tools

ToolWhat it does
ba_searchCar ads with filters, 30 per page, sortable.
ba_adOne car, motorcycle or truck ad in full, with the real number of ads for that model; optional similar ads.
ba_market_statsMin, quartiles, median, max asking price for a model, per year, from live ads.
ba_new_pricesToday's price of new-car trims (market, factory, dealer) with daily change and trend.
ba_dealersShowrooms with ads for a model or city, with address and rating.
ba_search_bikes_trucksMotorcycle or truck ads with filters (brand, year, price, city, body, usage...).
ba_dealer_adsOne dealer's inventory (up to 100 ads) with filters and sorting.
ba_price_listSearch and rank the daily new-car or motorcycle price list by brand, price type, origin.
ba_market_pulseToday's market score and analysis plus the biggest new-car price movers.
ba_car_specsTechnical specs, expert rating, pros and cons, trims of a car or motorcycle model.
ba_vehiclesBrand, model and trim values for the other tools (cars, motorcycles, trucks).
ba_filtersValues 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.

Source: README.md at commit d580332

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

3
  1. v0.2.0LatestNov 7, 2026
  2. v0.1.1Nov 3, 2026
  3. v0.1.0Nov 1, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts