divar-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DIVAR_TIMEOUT | No | Timeout for HTTP requests in seconds | |
| DIVAR_CACHE_TTL | No | Time-to-live for cached responses | |
| DIVAR_MIN_INTERVAL | No | Minimum interval between requests in seconds (default 0.8) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| divar_searchA | Search live divar.ir listings (Iran's largest classifieds). Read-only, no account needed. Supports text query, city, category, Toman price range, photo-only, district ids and brand/model, with cursor pagination. Returns normalized rows (token, title, price in Toman, city, district, relative time, image, url). |
| divar_get_postA | Full public detail for one divar.ir post: title, description, price in Toman, structured attributes (brand/model, year, mileage, ...), image URLs, Jalali and ISO posted/updated dates, city/district, category breadcrumb and its district id (usable as a divar_search filter). |
| divar_price_analysisA | Price distribution of comparable live listings for an item, to decide what to ask before posting an ad (median, p25/p75, suggested ask range, price bands, freshness, cheapest and priciest samples). Prices in Toman. |
| divar_similar_postsA | Comparable listings for an existing post: same category, brand/model and city, excluding the post itself. Useful for a seller checking competition or a buyer checking the price. |
| divar_list_citiesA | Look up divar.ir city ids by Persian name (or list them all). |
| divar_list_categoriesA | Look up divar.ir category slugs by Persian or English text, with their breadcrumb parents. Use the slug in divar_search/divar_price_analysis. |
| divar_post_filtersB | Show which filters divar.ir exposes for a city/category (price range, districts, photo-only). |
| divar_search_urlA | Build a divar.ir web URL for a search, so a human can open it in a browser. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Each tool targets a distinct concern: searching, fetching details, analyzing prices, finding similar posts, and listing metadata (cities, categories, filters). Even the two analysis tools (price_analysis vs similar_posts) are clearly differentiated by their purpose—one focuses on price distribution, the other on comparable listings. No real ambiguity exists.
All tools share the 'divar_' prefix, which provides a clear namespace. The pattern is mostly verb_noun (search, get_post, list_cities) but some are noun phrases (price_analysis, similar_posts, post_filters). The style is consistent (snake_case) and readable, though not perfectly uniform in verb usage.
Eight tools is ideal for a read-only classifieds analysis server. Each tool serves a distinct role in the workflow—discovering, inspecting, analyzing, and building URLs—without unnecessary overlap or bloat. The count is well-scoped for the stated purpose.
The server covers the core read-only lifecycle: search, get detail, price analysis, similar items, and lookups for cities, categories, and filters. It lacks a method to post or manage listings, but that's outside its declared read-only scope. Minor gaps like district-level listing or user info are non-essential for the intended use case.