Divar

divar-mcp: Divar MCP server for AI agents

Let your AI agent search Divar (دیوار) ads in any Iranian city, and tell it whether a price is fair.

An unofficial, read-only MCP server for Divar, Iran's largest classifieds site (homes, cars, phones, jobs, services).

Search, read ads, compare, find the cheapest and best-value ads, appraise prices and browse the map from Claude, Cursor or Copilot. Prices are in Toman.

For AI agents · Why · What it can do · Quick start · Tools · How it works · Good to know · FAQ · Configuration · فارسی · Development

For AI agents

• What: unofficial MCP server (model context protocol) for Divar (دیوار, divar.ir), Iran's classifieds site. Persian queries work best; Arabic letter variants (ي/ك) are folded.
• Install: uvx divar-mcp or claude mcp add divar -- uvx divar-mcp. Transport: stdio. Needs uv (Python 3.10+).
• Auth: none, no API key or account. Optional DIVAR_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
• Access: read-only on Divar. It cannot log in, post, chat, bookmark or reveal a seller's phone number, so no confirmation is needed before calling a tool. Only dv_watch and dv_price_trend write, and only to a local file of your own searches.
• Tools: 31, all prefixed dv_. Start with dv_search, dv_post, dv_cheapest, dv_best_for_budget, dv_market.
• Typical sequence: dv_cities / dv_categories -> dv_filters -> dv_search -> dv_post -> dv_similar / dv_appraise / dv_compare.
• Also: resources divar://cities, divar://categories, divar://category-filters/{slug}; prompts compare_ads, best_under_budget, appraise_listing, watch_market.
• Units: prices in Toman (Divar's own unit, nothing is converted). price for a sale; deposit + rent for a rental (rent 0 with full_deposit means رهن کامل); no price means negotiable.
• Use when: the user wants to find, price-check or monitor Divar ads (flats to buy or rent, used cars, phones, furniture, jobs...), or asks what something costs in a city.
• Do not use when: the user wants to post an ad, message a seller or get a phone number (login-only on Divar), or needs a market other than Divar.
• Output: compact JSON ad cards. Pass token between tools and next_cursor back as cursor.
• Machine-readable: server.json and the iran-mcp catalog (TOOLS.md, servers.json, llms.txt).

Why

Divar is where Iranians buy and sell flats, cars and phones, but answering "what is a fair price for a 2-bedroom flat in Vanak?" means scrolling through dozens of ads and ignoring the fake prices. With divar-mcp an agent fetches the ads, drops placeholder prices, computes the median and quartiles of the asking prices, and tells you which ads are well below them.

You: Find the best 2-bedroom flat to rent in Vanak with a deposit under 1 billion Toman.

Agent: *calls* dv_parse_query -> dv_best_for_budget -> dv_post

It lists the best-value ads against the median of the ads that fit, with the reasons for each score, then opens the one you pick.

What it can do

• Search ads in one or several cities by category, text, neighbourhood, price (and deposit for rentals), brand and model, photo, freshness and every other filter of the category; merge several pages with duplicates removed; continue with a cursor
• Read a full ad: price in Toman, specs, features, description, all images, map position, seller type, placeholder-price detection
• Find value: cheapest ads (junk prices skipped), best value and most-for-the-budget, ads priced well below the median, side-by-side comparison showing only the differences, similar ads
• Judge a price: fair-price appraisal with percentile and confidence, market statistics by district and by day
• Monitor: poll dv_new_since with the last timestamp to see only new ads; keep saved searches and a daily median price trend locally; export results as CSV or JSON lines
• Use the map: ads around a GPS point or landmark with distances; neighbourhoods, neighbours, borders, address of a point
• Look at sellers and dealers: how many ads a seller has, the business card and its ads

Example prompts:

• "Cheapest used Peugeot 206 in Tehran, and is it priced fairly compared with similar ads?"
• "Find apartments to rent near Vanak under 8 billion Toman and compare the top three."
• "Show new iPhone 15 ads in Mashhad since this morning."
• "What is the median price per square metre for apartments for sale in Gisha?"
• ارزان‌ترین آپارتمان ۲ خوابه اجاره‌ای در ونک با ودیعه زیر ۱ میلیارد کدام است؟
• قیمت این ماشین نسبت به آگهی‌های مشابه گران است یا ارزان؟
• آگهی‌های جدید گوشی آیفون ۱۵ در مشهد را از امروز صبح نشان بده.

Quick start

You need uv. No API key or account.

Claude Code

claude mcp add divar -- uvx divar-mcp

Claude Desktop

Settings → Developer → Edit Config, then add:

{

"mcpServers": { "divar": { "command": "uvx", "args": ["divar-mcp"] } } }

</details>

Cursor

Add the Claude Desktop block above to ~/.cursor/mcp.json (or .cursor/mcp.json in a project).

VS Code (Copilot agent mode)

Click Install in VS Code above, or add to .vscode/mcp.json:

{

"servers": { "divar": { "type": "stdio", "command": "uvx", "args": ["divar-mcp"] } } }

</details>

Codex CLI

codex mcp add divar -- uvx divar-mcp

Or in ~/.codex/config.toml:

[mcp_servers.divar]

command = "uvx" args = ["divar-mcp"]

</details>

Gemini CLI

Add to ~/.gemini/settings.json:

{

"mcpServers": { "divar": { "command": "uvx", "args": ["divar-mcp"] } } }

</details>

Windsurf

Add the Claude Desktop block to ~/.codeium/windsurf/mcp_config.json.

Anything else

It is a standard stdio MCP server: run uvx divar-mcp, or pip install divar-mcp and run divar-mcp.

Tools

An ad card has token, title, price (sale) or deposit + rent (rent 0 with full_deposit means رهن کامل), info (mileage, condition...), district, seller (agency label), age_h (hours since the last bump), photos, image (thumbnail URL, only from dv_search with thumbnails), chat, tag (paid promotion), url, and suspect_price when the price looks like a placeholder. Absent flags mean false. Default page size is 10 to 20 ads.

All tools start with dv_ and are annotated read-only, except dv_watch and dv_price_trend, which write only to a local file.

Find places and categories

Search and price

One ad and its seller

How it works

  AI agent  (Claude, Cursor, Copilot, ...)

│ │ MCP over stdio ▼ diva