# Digikala (pypi · digikala-mcp)

Unofficial read-only Digikala: search products, compare sellers, price history, reviews, deals.

- Trust score: 80/100 (high trust)
- Change this week: −5
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-22

## Components

- pypi · `digikala-mcp`: 80/100 (this document), [markdown](https://verifymcp.io/servers/sepehr071-digikala-mcp/digikala-mcp.md), [page](https://verifymcp.io/servers/sepehr071-digikala-mcp/digikala-mcp)

## Channel facts

- Registry: `pypi`
- Package: `digikala-mcp`
- Version: `0.5.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-22.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - Runs hatchling.build at install time, a recognised build step with no custom scripting around it.
  - 1 of 35 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to sepehr071/digikala-mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 0 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 62/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 4375 tokens (~190/item across 23 items; 23 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 13/100
  - Stability check failed: the tool surface changed between 0.1.0 and 0.5.1: 0 tool removals, 20 breaking changes, 3 additions.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 23 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 24 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the Digikala MCP server?

Digikala runs locally as a PyPI package, launched with uvx digikala-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add sepehr071-digikala-mcp -- uvx digikala-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "sepehr071-digikala-mcp": {
      "command": "uvx",
      "args": [
        "digikala-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "sepehr071-digikala-mcp": {
      "command": "uvx",
      "args": [
        "digikala-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add sepehr071-digikala-mcp -- uvx digikala-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sepehr071-digikala-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "digikala-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add sepehr071-digikala-mcp --command uvx --arg digikala-mcp
```

### Hermes

```yaml
mcp_servers:
  sepehr071-digikala-mcp:
    command: "uvx"
    args: ["digikala-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "sepehr071-digikala-mcp": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "digikala-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add sepehr071-digikala-mcp -t stdio -c uvx -a digikala-mcp
```

### Other

```json
{
  "mcpServers": {
    "sepehr071-digikala-mcp": {
      "command": "uvx",
      "args": [
        "digikala-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-22 (score 80, 0)

- [security regression] Stability: fail → unverified
- [security regression] Tool safety: pass → unverified
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional] Package version: 0.5.0 → 0.5.1

### 2026-10-20 (score 80, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7.

### 2026-10-18 (score 79, 0)

- [security regression] Stability: fail → unverified
- [security regression] Tool safety: pass → unverified
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional] Package version: 0.4.0 → 0.5.0

### 2026-10-16 (score 79, −6)

- [security regression] Stability: 0.40 → unverified
- [security regression] Tool safety: pass → unverified
- [security regression] Stability: 0.40 → fail
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional improvement] Schema quality: 209 → 187
- [functional] Schema quality: excellent → good
- [functional] Package version: 0.3.2 → 0.4.0

### 2026-10-14 (score 85, +36)

- [security improvement] Injection markers: unverified → pass
- [functional regression] Schema quality: 179 → 209
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Stability: unverified → 0.37
- [functional improvement] MCP protocol: unverified → pass
- [functional] Package version: 0.1.0 → 0.3.2

### 2026-10-13 (score 49, 0)

- [functional] Package version: 0.3.1 → 0.3.2
- [functional] Package version: 0.1.0 → 0.3.1

### 2026-10-12 (score 49, −31)

- [security regression] Tool safety: pass → unverified
- [security] Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional] First check of Schema quality: unverified
- [functional] Package version: 0.1.0 → 0.3.1

### 2026-10-04 (score 80, +15)

- [security improvement] Malware scan: unverified → pass

## MCP tools (23)

### `dk_search` (~373 tokens)

Search products

Search products by name: price (Toman), discount, seller, rating, 20 per page.

Search also returns loosely related items: each product has `match` ('all', 'some' with
\`missing_words`, or 'none'); prefer 'all'. Filter ids come from dk_filters(query=...).
sort=cheapest puts accessories first: use dk_find_cheapest for the cheapest real match.
Next: dk_product for every seller's offer.

Input parameters:

- `attributes`: Feature filters from dk_filters: {attribute id: [value ids]}, e.g. {2226: [19239]}. Values OR, attributes AND.
- `brand_ids`: Brand ids from dk_product's brand_id or dk_brand_products' brand.id, e.g. [18] Samsung, [1662] Xiaomi.
- `colors`: Color ids from dk_filters, e.g. [1].
- `fast_delivery` (boolean): Only items with fast (Jet) delivery.
- `in_stock_only` (boolean): Only products that can be bought now.
- `max_price`: Highest price in Toman, e.g. 50000000.
- `min_price`: Lowest price in Toman, e.g. 10000000 for 10 million Toman.
- `page` (integer): Page number, from 1 (20 products per page).
- `query` (string, required): Product name or words, Persian or English, e.g. 'گوشی سامسونگ' or 'airpods pro'.
- `ready_to_ship` (boolean): Only items already in Digikala's warehouse (ship sooner).
- `seller_type`: Only offers from Digikala itself, official brand sellers, trusted sellers or rural (roosta) sellers.
- `sort` (string): Order of the results.

### `dk_find_cheapest` (~197 tokens)

Find cheapest product

Find the cheapest in-stock products that really match a query, sorted by price (Toman).

Scans the top relevant results, keeps titles with every query word (else any word, with a
\`note`) and drops accessories. Use for "cheapest X"; then dk_product on the winner, as another
seller may sell it for less.

Input parameters:

- `limit` (integer): Max products to return.
- `max_price`: Highest price in Toman, e.g. 50000000.
- `min_price`: Skip anything cheaper than this, in Toman. Default: a quarter of the median price of the top matches (ignoring max_price), which drops accessories.
- `pages` (integer): Relevance pages to scan, 20 products each.
- `query` (string, required): Product name or words, Persian or English, e.g. 'گوشی سامسونگ' or 'airpods pro'.

### `dk_best_for_budget` (~234 tokens)

Best picks for a budget

Rank the best-rated in-stock products within a budget (Toman) by a rating weighted by its count.

A 5.0 from 3 buyers does not beat a 4.6 from 900; ties go to the cheaper one. A query keeps only
titles with every word and drops accessories. Use for "best X under Y"; then dk_product, dk_reviews.

Input parameters:

- `category_code`: Or a category code instead of a query, e.g. 'mobile-phone' (from dk_suggest).
- `limit` (integer): Max picks to return.
- `max_price` (integer, required): Budget in Toman, e.g. 20000000 for 20 million Toman.
- `min_price`: Skip anything cheaper, in Toman. Default for a query: a floor that drops accessories.
- `min_ratings` (integer): Skip products with fewer ratings than this.
- `pages` (integer): Result pages to scan, 20 products each.
- `query`: What to buy, e.g. 'هدفون بی سیم' or 'گوشی سامسونگ'.

### `dk_suggest` (~63 tokens)

Search suggestions

Autocomplete a vague or misspelled query into keywords, categories and brands.

Next: dk_search with a keyword, or dk_category_products with a category code.

Input parameters:

- `query` (string, required): Partial text, e.g. 'samsung' or 'هدفون'.

### `dk_filters` (~201 tokens)

Filter options

List the filters of a category or a search: attributes, colors, sellers, price range (Toman), brands.

Attributes give {value title: id}; one with over 15 values only has `value_count`: call again
with attribute_id. Colors are {title: id}; brands {code: id} (category only); categories
{code: title} (query only). Pass the ids to dk_category_products or dk_search
(attributes={attribute id: [value ids]}, colors, seller_type, brand_ids).

Input parameters:

- `attribute_id`: Return only this attribute with all its values, e.g. 2251 (phone storage).
- `brand_code`: With category_code: only this brand, e.g. 'samsung'.
- `category_code`: Category code from dk_suggest or dk_categories, e.g. 'mobile-phone'.
- `query`: Search words instead of a category, e.g. 'هدفون بی سیم'.

### `dk_categories` (~134 tokens)

Find categories

Find category codes for dk_category_products and main-category ids for dk_best_sellers.

query matches the Persian name or English code (Persian finds more: 'لپ تاپ' finds the laptop
leaf, 'laptop' does not); parent_id lists children; neither lists the main categories. A category
with subcategories mixes in accessories: browse its product leaf.

Input parameters:

- `limit` (integer): Max categories to return.
- `parent_id`: List the sub-categories of this category id.
- `query`: Words in the category name or code, e.g. 'هدفون' or 'laptop'.

### `dk_category_products` (~373 tokens)

Browse a category

List one category's products with sort and filters (price in Toman), strict order.

E.g. "cheapest laptops" (category 'notebook-netbook-ultrabook'), "best-selling Xiaomi phones"
(brand_code='xiaomi'). Feature ids come from dk_filters(category_code=...). No text query here.

Input parameters:

- `attributes`: Feature filters from dk_filters: {attribute id: [value ids]}, e.g. {2226: [19239]}. Values OR, attributes AND.
- `brand_code`: Only this brand: its English slug, e.g. 'xiaomi' or 'lenovo' (dk_product's brand_code).
- `brand_ids`: Brand ids from dk_product's brand_id or dk_brand_products' brand.id, e.g. [18] Samsung, [1662] Xiaomi.
- `category_code` (string, required): Category code from dk_categories, dk_suggest or dk_product, e.g. 'mobile-phone'.
- `colors`: Color ids from dk_filters, e.g. [1].
- `fast_delivery` (boolean): Only items with fast (Jet) delivery.
- `in_stock_only` (boolean): Only products that can be bought now.
- `max_price`: Highest price in Toman, e.g. 50000000.
- `min_price`: Lowest price in Toman, e.g. 10000000 for 10 million Toman.
- `page` (integer): Page number, from 1 (20 products per page).
- `ready_to_ship` (boolean): Only items already in Digikala's warehouse (ship sooner).
- `seller_type`: Only offers from Digikala itself, official brand sellers, trusted sellers or rural (roosta) sellers.
- `sort` (string): Order of the results.

### `dk_brand_products` (~184 tokens)

Browse a brand

List a brand's products with sort and price filters (Toman), plus the brand id for brand_ids.

For one brand inside one category use dk_category_products(brand_code=...).

Input parameters:

- `brand_code` (string, required): Brand code: usually the lowercase English brand name (as in digikala.com/brand/<code>/, or dk_product's brand_code), e.g. 'samsung' or 'xiaomi'.
- `in_stock_only` (boolean): Only products that can be bought now.
- `max_price`: Highest price in Toman, e.g. 50000000.
- `min_price`: Lowest price in Toman, e.g. 10000000 for 10 million Toman.
- `page` (integer): Page number, from 1 (20 products per page).
- `sort` (string): Order of the results.

### `dk_seller` (~124 tokens)

Seller profile and products

Get a seller's reputation (rating 0-5, on-time shipping, cancellations, returns) and products.

Use before recommending an unknown seller. Percentages are the share of good orders (100 = never late).

Input parameters:

- `in_stock_only` (boolean): Only products that can be bought now.
- `page` (integer): Page number, from 1 (20 products per page).
- `seller_code` (string, required): Seller code from dk_product offers or a product card, e.g. 'CGDG9'.
- `sort` (string): Order of the results.

### `dk_deals` (~175 tokens)

Current deals

List today's Incredible Offers (flash deals), biggest discount first, in-stock only.

Each product has discount_pct, price_before_discount and deal_ends (Tehran time). store='supermarket' lists Fresh deals.

Input parameters:

- `max_price`: Highest price in Toman, e.g. 50000000.
- `min_price`: Lowest price in Toman, e.g. 10000000 for 10 million Toman.
- `page` (integer): Page number, from 1 (20 products per page).
- `query`: Optional words to narrow the deals, e.g. 'هدفون' or 'شیر'.
- `sort` (string): Order of the deals.
- `store` (string): 'digikala' for Incredible Offers, 'supermarket' for Digikala Fresh grocery deals.

### `dk_best_sellers` (~79 tokens)

Best sellers

List current best sellers, overall or in one main category; also returns the main categories' ids for category_id.

Input parameters:

- `category_id`: Main category id from dk_categories (no arguments) or this tool's `categories`, e.g. 1 for mobile. Leaf ids are rejected.
- `limit` (integer): Max products to return.

### `dk_fresh_search` (~245 tokens)

Search groceries

Search or browse Digikala Fresh (supermarket). category_code beats query and also returns sub-categories.

For grocery discounts use dk_deals(store='supermarket').

Input parameters:

- `category_code`: Fresh category code instead of a query: groceries, dairy, snacks, protein-foods, breakfast, beverages, warm-drinks, fruits-and-vegetables, personal-hygiene, baby-and-mother, home-hygiene, dried-fruit…
- `in_stock_only` (boolean): Only products that can be bought now.
- `max_price`: Highest price in Toman, e.g. 50000000.
- `min_price`: Lowest price in Toman, e.g. 10000000 for 10 million Toman.
- `page` (integer): Page number, from 1 (20 products per page).
- `query`: Grocery product, Persian works best, e.g. 'شیر کم چرب' or 'برنج'.
- `sort` (string): Order of the results.

### `dk_product` (~197 tokens)

Product details and offers

Get one product's price, stock, rating, specs and every seller's offer (cheapest first).

An offer is one color/size from one seller: price (Toman), stock_left (only when low), warranty,
seller rating 0-5, ships_by ('digikala', 'jet' = same-day Tehran/Karaj, 'seller'), free_shipping.
lowest_price_30d can be a one-day dip of one color; dk_price_history's lowest_2_days is steadier.
Groceries have store='supermarket' and a price that can differ from dk_search's.

Input parameters:

- `include_specs` (boolean): Include the specification table.
- `max_offers` (integer): Max seller offers to return, cheapest first.
- `product_id` (integer, required): Digikala product id, the number in 'dkp-<id>' (from dk_search etc.), e.g. 20109389.

### `dk_price_history` (~122 tokens)

Price history

Get ~30 days of daily buy-box prices (Toman) per color/variant, with lowest and highest.

For "is this a good price?": `lowest_2_days` is the lowest price held two days in a row (`lowest`
can be a one-day dip). Days are Jalali. An unknown id gives no variants; check it with dk_product.

Input parameters:

- `product_id` (integer, required): Digikala product id, the number in 'dkp-<id>' (from dk_search etc.), e.g. 20109389.

### `dk_reviews` (~186 tokens)

Product reviews

Read customer reviews: stars 1-5 (null = none), text, pros/cons, verified buyer flag.

The overall rating (0-5) is in dk_product. Texts are cut to 300 characters, pros/cons to 5 of 80;
full_text=true returns them whole. An unknown id gives no reviews; check it with dk_product.

Input parameters:

- `full_text` (boolean): Skip text cuts and pros/cons caps; return everything whole.
- `limit` (integer): Max reviews from the page (20 per page).
- `page` (integer): Page number, from 1 (20 products per page).
- `product_id` (integer, required): Digikala product id, the number in 'dkp-<id>' (from dk_search etc.), e.g. 20109389.
- `sort` (string): Order of the reviews.

### `dk_questions` (~146 tokens)

Product questions and answers

Read customers' questions (20 per page) with up to 2 answers each (answered_by: buyer, seller, ...).

Texts are cut to 300 characters (full_text=true: whole). Use for practical doubts (compatibility, size, registration).

Input parameters:

- `full_text` (boolean): Skip text cuts and pros/cons caps; return everything whole.
- `page` (integer): Page number, from 1 (20 products per page).
- `product_id` (integer, required): Digikala product id, the number in 'dkp-<id>' (from dk_search etc.), e.g. 20109389.
- `sort` (string): Order of the questions.

### `dk_similar` (~118 tokens)

Similar products

List products similar to one (same kind, other models and brands).

sort='cheapest' gives cheaper alternatives; then dk_compare.

Input parameters:

- `in_stock_only` (boolean): Only products that can be bought now.
- `page` (integer): Page number, from 1 (20 products per page).
- `product_id` (integer, required): Digikala product id, the number in 'dkp-<id>' (from dk_search etc.), e.g. 20109389.
- `sort` (string): Order of the results.

### `dk_compare` (~108 tokens)

Compare products

Compare 2-4 products side by side: price and rating, then the spec rows where they differ.

\`values` in a `specs` row follow the order of `products` (null = no such spec); identical rows
fold into `same_specs`. Best within one category. Unknown ids are listed in `missing_ids`.

Input parameters:

- `product_ids` (array, required): 2-4 product ids of the same kind, e.g. [20109389, 20110013].

### `dk_shortlist` (~163 tokens)

Re-check a shortlist

Re-price up to 10 products in one call: price, cheapest offer, stock, rating and 30-day low (Toman).

Use to refresh a watched list or check stock. `cheapest_offer` can be below `price` (the featured
offer). `low_30d` is the lowest price held two days in a row, `vs_30d_low_pct` today's price above
it (0 = at the low); `lowest_one_day_30d` is Digikala's figure, possibly a one-day dip.
For specs use dk_compare; for the daily curve dk_price_history.

Input parameters:

- `product_ids` (array, required): 1-10 product ids, e.g. [20109389, 20110013].

### `dk_installments` (~124 tokens)

Installment plans

Get the Digipay credit-line offers for a product, in Toman.

A plan is a fixed credit line (credit_amount) repaid in `months` installments of monthly_repayment;
it is not sized to the product price, so never present it as "this product for X a month".
Needs Digipay approval. An unknown id gives no plans; check it with dk_product.

Input parameters:

- `product_id` (integer, required): Digikala product id, the number in 'dkp-<id>' (from dk_search etc.), e.g. 20109389.

### `dk_plus_plans` (~43 tokens)

Digikala Plus plans

List Digikala Plus plans (free shipments per month: jet = same-day Tehran/Karaj, fresh = supermarket) with price in Toman and benefits.

### `dk_gold_prices` (~75 tokens)

Gold and coin prices

Get the live 18k gold price per gram and gold coin prices, in Toman.

gold18_day_change_pct is vs the previous daily point; period change, low and high cover the ~3-month
chart. Coins' change_pct is as Digikala shows it. Coins with price null are not for sale.

### `dk_location` (~132 tokens)

Find location

Turn an address into coordinates, or coordinates into an address with Digikala's city_id and state_id.

Pass address + city, or lat + long. Prices are the same everywhere; location only affects delivery.

Input parameters:

- `address`: Address or landmark in Persian, e.g. 'میدان ونک'. Latin text matches poorly.
- `city`: Persian city name; without it most addresses find nothing, e.g. 'تهران' or 'مشهد'.
- `lat`: Latitude, to describe a point instead (Iran: ~25 to ~40).
- `long`: Longitude, with lat.

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Dependencies. The full working is on the page: https://verifymcp.io/servers/sepehr071-digikala-mcp/digikala-mcp#diagnostics

## Score history

- 2026-10-22: 80
- 2026-10-21: 80
- 2026-10-20: 80
- 2026-10-19: 79
- 2026-10-18: 79
- 2026-10-17: 79
- 2026-10-16: 79
- 2026-10-15: 85
- 2026-10-14: 85
- 2026-10-13: 49
- 2026-10-12: 49
- 2026-10-04: 80
- 2026-10-03: 65

## Common questions

### What is the Digikala MCP server?

Digikala is an MCP server listed in the public MCP registry as io.github.sepehr071/digikala-mcp. Unofficial read-only Digikala: search products, compare sellers, price history, reviews, deals. This page covers its PyPI package (digikala-mcp).

### Is the Digikala MCP server safe to use?

Digikala scores 80 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 22 October 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Digikala MCP server expose?

Digikala exposes 23 tools: dk_search, dk_find_cheapest, dk_best_for_budget, dk_suggest, dk_filters, and 18 more. Their descriptions and schemas cost roughly 3,796 tokens of context every time the server is loaded.

### Is the Digikala MCP server still maintained?

Digikala is still listed as active in the MCP registry. We last reached this channel on 22 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Digikala MCP server under?

Digikala declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- PyPI project: https://pypi.org/project/digikala-mcp/
- Socket report: https://socket.dev/pypi/package/digikala-mcp
- Repository: https://github.com/sepehr071/digikala-mcp
- Changelog RSS feed: https://verifymcp.io/servers/sepehr071-digikala-mcp/digikala-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/sepehr071-digikala-mcp/digikala-mcp.json
- HTML version of this page: https://verifymcp.io/servers/sepehr071-digikala-mcp/digikala-mcp