Digikala

digikala-mcp: Digikala MCP server for AI agents

Let your AI agent shop around on Digikala (دیجی‌کالا).

An unofficial, read-only MCP server for Iran's largest online store: search products, compare every seller's offer,

check a product's price history, read reviews and Q&A, and catch today's Incredible Offers, all from Claude, Cursor or Copilot.

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

For AI agents

• What: unofficial MCP server (model context protocol) for Digikala (digikala.com, Iran) and its Fresh supermarket. Queries in Persian or English, prices in Toman.
• Install: uvx digikala-mcp or claude mcp add digikala -- uvx digikala-mcp. Transport: stdio. Needs uv (Python 3.10+).
• Auth: none, no API key or account. Optional DIGIKALA_MCP_PROXY (HTTP proxy, or a comma-separated list, e.g. with an Iranian exit if Digikala blocks yours).
• Access: read-only. No login, cart, checkout or payment, so no confirmation is needed before calling any tool.
• Tools: 23, all prefixed dk_. Start with dk_find_cheapest, dk_search, dk_best_for_budget, dk_deals. Typical sequence: dk_find_cheapest -> dk_product -> dk_price_history.
• Use when: finding, comparing or judging prices of products and sellers on Digikala, including the Fresh supermarket.
• Do not use when: the user wants to buy, or needs shipping cost (only calculated at checkout) or anything behind a login.
• Output: compact JSON. Prices in Toman, ratings 0-5 (null = not rated). Numeric product ids (the of dkp- ) pass between tools.
• Network: talks to api.digikala.com directly from your machine. On "refused the request (HTTP 403)" for every call, set DIGIKALA_MCP_PROXY.
• Machine-readable: server.json and the iran-mcp catalog (TOOLS.md, servers.json, llms.txt).

Why

Digikala lists the same phone many times: different colors, memory sizes, bundles and a dozen sellers per listing, with prices that move every day. Sorting by "cheapest" puts phone cases first. Finding *the real cheapest offer, and whether today's price is a good one* means a lot of clicking. An agent with digikala-mcp does it in three calls:

You: Cheapest Samsung Galaxy A07 on Digikala, and is now a good time to buy?

Agent: *calls* dk_find_cheapest(query="samsung a07") → dk_product(product_id=20109389) → dk_price_history(product_id=20109389)

| Price | Model | Seller |

|---:|---|---|

| 42,503,600 | Galaxy A07 64 GB / 4 GB | Digikala (same-day delivery in Tehran) |

| 44,518,000 | Galaxy A07 64 GB / 4 GB + 25 W charger | Sepahan Hamrah Yaghout |

| 46,811,800 | Galaxy A07 128 GB / 4 GB | Digikala |

The 64 GB model is cheapest at 42,503,600, sold by Digikala itself; the next seller asks 42,918,000.

But it's not a great moment: the black one sold for 34,499,000 yesterday and 33,200,000 at its lowest this

month. Today's best offer is about 23% above yesterday's, so waiting may pay off.

Real tool output from 2026-10-03; prices change all the time. Prices are in Toman.

What it can do

• Search the whole catalogue in Persian or English, with price, brand, feature (OS, storage, ...), color, seller and fast-delivery filters; every result says whether its title really matches
• Find the real cheapest match, with accessories filtered out, and every seller's offer for a product
• Best picks for a budget, ranked by a rating weighted by how many buyers rated it, with the reasoning shown
• Re-check a shortlist of up to 10 products in one call: price, cheapest offer, stock, distance from the 30-day low
• Judge a price with about 30 days of daily price history and the 30-day low
• Browse categories, brands, sellers and best sellers, sorted by price, sales, views, newest or buyers' pick
• Check quality with reviews, pros/cons, buyer Q&A and seller reputation
• Catch deals: Incredible Offers and supermarket (Digikala Fresh) discounts
• Extras: spec comparison, installment plans, Digikala Plus shipping plans, live gold and coin prices
• Read-only by design: no login, no cart, no orders, no payment

Quick start

You need uv. No API key or account.

Claude Code

claude mcp add digikala -- uvx digikala-mcp

Claude Desktop

Settings → Developer → Edit Config, then add:

{

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

</details>

Cursor

Click Install in Cursor above, or add the Claude Desktop block to ~/.cursor/mcp.json.

VS Code (Copilot agent mode)

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

{

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

</details>

Codex CLI

codex mcp add digikala -- uvx digikala-mcp

Or in ~/.codex/config.toml:

[mcp_servers.digikala]

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

</details>

Gemini CLI

Add to ~/.gemini/settings.json:

{

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

</details>

Windsurf

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

Anything else

It's a standard stdio MCP server: run uvx digikala-mcp, or pip install digikala-mcp and run digikala-mcp.

Then just ask:

• "Cheapest AirPods-style earbuds under 3 million Toman with at least 4 stars?"
• "Compare the Galaxy A07 64 GB and 128 GB. Is the bigger one worth the difference?"
• "Is this seller reliable? CGDG9"
• "What are today's Incredible Offers on headphones, biggest discount first?"
• "Which Android phones with 256 GB sold by Digikala itself are under 20 million Toman?"
• ارزان‌ترین شیر کم‌چرب در سوپرمارکت دیجی‌کالا چند است؟
• ارزان‌ترین گوشی سامسونگ A07 کدام است و الان وقت خرید است؟
• امروز چه شگفت‌انگیزی برای هدفون هست؟

Tools

Product ids are the number in a digikala.com/product/dkp- / link. Every list returns compact product cards: id, title, brand, price, discount, stock, seller, rating, a photo URL (image) and the product link.

Find products (12)

Products (8)

Other (3)

All 23 tools are annotated readOnlyHint: true and return compact structured JSON, so they don't flood the agent's context.

How it works

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

│ │ MCP over stdio ▼ digikala-mcp (runs on your machine) │ │ HTTPS └──────▶ api.digikala.com products, sellers, deals, Fresh supermarket

digikala-mcp runs locally and calls the same public endpoints the digikala.com web app uses. There's no hosted server in between, no API key, and nothing about you is sent anywhere else.

Good to know

• Prices are in Toman. The Digikala API answers in Rial; every tool divides by 10 so numbers match the website. Gold and coin prices are already Toman.
• Ratings are 0–5, like the site (the API's 0–100 divided by 20); null means not rated yet. Review stars are 1–5.
• Persian and English queries both work (گوشی سامسونگ, airpods pro). Category and brand codes are English slugs (mobile-phone, samsung).
• **sort=cheapest on a text search shows accessories