Digikala MCP - shop intelligence for AI agents

A public MCP server that gives AI agents real data from Digikala - Iran's largest online marketplace: search, prices in Toman, discounts, ratings, sellers, reviews, deals and bestsellers. Read-only, no key needed.

Live endpoint: https://digikala-mcp.mmdju.workers.dev/mcp (Streamable HTTP)

نسخه فارسی · Examples · Tool reference · Changelog

Connect in 30 seconds

Any Streamable HTTP MCP client, one URL. Cline / Cursor / Claude Desktop (mcp.json style):

{
  "mcpServers": {
    "digikala": { "url": "https://digikala-mcp.mmdju.workers.dev/mcp" }
  }
}

Then just talk: "best Samsung phone under 100 million Toman", "is this laptop any good?", "what is on deal today?", "what is popular in Iran right now?".

No client at hand? The whole protocol is one POST - a real call:

curl -sS https://digikala-mcp.mmdju.workers.dev/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_digikala","arguments":{"query":"هدفون بی سیم","limit":2}}}'

And a real answer, trimmed to its bones (Toman, as JSON numbers):

{
  "query": "هدفون بی سیم",
  "returned": 2,
  "items": [
    { "id": 5112620, "title": "هدفون بی سیم مدل P47 5.0+EDR", "price_toman": 800000, "rating_stars": 3.7, "url": "https://www.digikala.com/product/dkp-5112620/" },
    { "id": 19019009, "title": "هدفون بلوتوثی مدل P9 V5.3 ...", "price_toman": 900000, "rating_stars": 3, "url": "https://www.digikala.com/product/dkp-19019009/" }
  ]
}

19 tools, grouped by the question

Find it

Tool	What it answers
digikala_suggest	Vague wording to real search terms, category ids, trends
search_digikala	"Show me X" - filters, sorting, paging
browse_category	Browse a category and drill into sub-categories
browse_tag	Digikala's own tag shelves - resolve a tag name, then browse it like a search
search_filters	"Which brands exist for X?" - brand / colour / category ids + price range
brand_lookup	Any brand name to its id, Persian or English

Know one product

Tool	What it answers
product_details	Everything about one product: price, seller, warranty, specs, delivery
product_url	Product id to shareable URL + title
product_variants	"Which colour is cheapest?" - every variant with its own price and seller, plus insurance, delivery and instalments
product_sellers	"Who else sells it, and are they reliable?" - every storefront behind one product, with Digikala's own performance numbers
product_price_chart	"Is now cheap?" - short price history with seller per point
product_reviews	"Is it any good?" - buyer-only and min-rating filters
product_questions	"What did buyers ask?" - questions with their answers, tagged seller / buyer / user

Decide

Tool	What it answers
compare_products	"Which of these?" - only the specs that actually differ
find_best_value	"Best X under Y Toman" - ranked picks, seller grade on the top pick
get_products_batch	Shortlist cards for up to 10 ids - feeds compare_products
similar_products	"What else is like this?" - Digikala's own recommendations

What is hot

| Tool | What it answers |

... View full README on GitHub