Digikala — Claude Code MCP server: what it does, how to install
Searches Digikala products, tracks 30-day price trends, compares seller offers, and pulls customer reviews directly into agent chats.
claude mcp add --env DIGIKALA_MCP_PROXY=<DIGIKALA_MCP_PROXY> --transport stdio digikala -- uvx digikala-mcpWhat Digikala does
This read-only server equips assistants with 23 tools prefixed by dk_ to query the Digikala marketplace and its Fresh supermarket. It processes queries in English or Persian, filters out accessories when hunting for the lowest price, and spots Incredible Offers deals. Prices are reported in Toman.
Requests require no user credentials or API tokens. The server cannot place orders or manage shopping carts. It also skips delivery calculations because the platform determines shipping fees only at checkout. Execution relies on uv alongside Python 3.10+.
Direct network calls target api.digikala.com. Whenever environments outside Iran encounter HTTP 403 errors, assigning an Iranian proxy to the DIGIKALA_MCP_PROXY variable resolves the issue.
What it helps with
- filter out phone cases and locate the cheapest merchant for an exact product
- inspect 30-day pricing history to verify whether a discount is genuine
- evaluate merchant ratings and customer reviews before buying
- track active discounts across Incredible Offers and Digikala Fresh
Example prompts for the agent
- Find the cheapest offer for Samsung Galaxy A07 on Digikala and show its price history.
- Check seller ratings, pros, and cons for Digikala product ID 20109389.
- List today's top deals in the Digikala Fresh supermarket under 5000000 Toman.
How to install Digikala
Platform CLI
claude mcp add --env DIGIKALA_MCP_PROXY=<DIGIKALA_MCP_PROXY> --transport stdio digikala -- uvx digikala-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from digikala-mcp <command>
Platform CLI
codex mcp add digikala --env DIGIKALA_MCP_PROXY=<DIGIKALA_MCP_PROXY> -- uvx digikala-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from digikala-mcp <command>
Config file
{
"mcpServers": {
"digikala": {
"command": "uvx",
"args": [
"digikala-mcp"
],
"env": {
"DIGIKALA_MCP_PROXY": "<DIGIKALA_MCP_PROXY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from digikala-mcp <command>
Config file
{
"servers": {
"digikala": {
"type": "stdio",
"command": "uvx",
"args": [
"digikala-mcp"
],
"env": {
"DIGIKALA_MCP_PROXY": "<DIGIKALA_MCP_PROXY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from digikala-mcp <command>
Platform CLI
gemini mcp add -e DIGIKALA_MCP_PROXY=<DIGIKALA_MCP_PROXY> digikala uvx digikala-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from digikala-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Digikala
How to install Digikala in Claude Code?
Run claude mcp add digikala-mcp -- uvx digikala-mcp. If you need a proxy to bypass IP blocks, run claude mcp add --env DIGIKALA_MCP_PROXY=<DIGIKALA_MCP_PROXY> --transport stdio digikala -- uvx digikala-mcp.
What does Digikala MCP server do?
It lets your agent search the Digikala catalog, compare marketplace sellers, check 30-day price graphs, and read reviews without an account.
Can this server place orders or calculate shipping fees?
No, all functions operate in read-only mode. Digikala calculates shipping costs only during checkout, which requires an authenticated session.
