Divar MCP server

<!-- mcp-name: io.github.sepehr071/divar-mcp -->

divar-mcp: Divar MCP server for AI agents

Unofficial, read-only MCP server that lets your AI agent search Divar (دیوار) ads in any Iranian city: homes, cars, phones and more. It finds the cheapest and best-value ads, compares ads, checks whether a price is fair and browses the map. Prices are in Toman.

An MCP server for Divar, Iran's largest classifieds site. Search by city, neighbourhood, category, text and any of the category's filters, read a full ad, compare several, see the seller's other ads, get market statistics, appraise a price against similar ads and poll for new ads, all from Claude, Cursor or Copilot. No account, no API key, nothing is posted or changed.

Quick start · Tools · FAQ · فارسی

For AI agents

• What: Unofficial MCP server for Divar (دیوار, divar.ir), Iran's classifieds site. Persian queries work best; prices in Toman.
• Install: claude mcp add divar -- uvx divar-mcp (stdio, needs uv and Python 3.10+).
• Auth: none. Optional DIVARMCPPROXY sets an HTTP proxy for every request.
• Access: read-only on Divar. It cannot log in, post, chat, bookmark or reveal a seller's phone number. Only dvwatch and dvprice_trend write, to a local file of your own searches.
• Also: resources divar://cities, divar://categories, divar://category-filters/{slug}; prompts compareads, bestunderbudget, appraiselisting, watch_market.
• Tools: 31, all prefixed dv. Start with dvsearch, dvpost, dvcheapest, dvbestforbudget, dvmarket.
• Typical sequence: dvcities / dvcategories -> dvfilters -> dvsearch -> dvpost -> dvsimilar / dvappraise / dvcompare.
• 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).
• Output: compact JSON ad cards. price for a sale; deposit + rent for a rental; no price means negotiable. Pass token between tools and next_cursor back as cursor.
• Machine-readable: server.json, and the catalog of all Iranian MCP servers awesome-iran-mcp (TOOLS.md, servers.json, llms.txt).

Quick start

You need uv.

claude mcp add divar -- uvx divar-mcp

Any other MCP client: command uvx, args ["divar-mcp"] (or pip install divar-mcp and run divar-mcp).

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
• Full ad: price in Toman, specs, features, description, all images, map position, seller type, shared-housing flag, placeholder-price detection
• Smart tools: cheapest ads (junk prices skipped), best value and most-for-the-budget, side-by-side comparison showing only the differences, similar ads, fair-price appraisal with percentile and confidence, market statistics by district and by day
• Monitoring: poll dvnewsince with the last timestamp to see only new ads; export results as CSV or JSON lines
• Map: ads around a GPS point or landmark with distances; neighbourhoods, neighbours, address of a point
• Sellers and dealers: how many ads a seller has, the business card and its ads

Tools

Shortened. The full README is on GitHub.