sepehr071 / masterkala

MasterKala

Unofficial read-only MasterKala: search gadgets, compare prices and specs, stock, delivery, deals.

The tools below come from the masterkala-mcp MCP server. If they are not available, install it with claude mcp add masterkala -- uvx masterkala-mcp, or add "masterkala": {"command": "uvx", "args": ["masterkala-mcp"]} to the client's MCP servers config. It needs uv. Restart the session after installing.

Tools

• mk_blog_posts: List MasterKala blog posts (buying guides, comparisons, how-tos), newest first, with links.
• mk_blog_comments: Read the comments of a blog post as threads, with the store writer's answers as replies.
• mk_search: Search MasterKala products by keyword: price, discount and stock of each match.
• mk_find_cheapest: Find the cheapest in-stock products for a keyword, one flat list sorted by payable price.
• mk_browse: List the products of a category, brand or tag with sorting, price range and filters.
• mk_filters: List the filters of a category, brand or tag page (brands, colors, attributes) with their ids, and its price range.
• mk_categories: List MasterKala's product categories with their ids (about 100 main categories).
• mk_brands: List the brands MasterKala sells with their slugs (about 135).
• mk_deals: List every product on MasterKala's discount page right now, biggest discount first.
• mk_product: Get one product's full record: price and discount (Toman), stock status and count, colors and
• mk_specs: Get the specification table of 1-4 products side by side, with each product's stock count.
• mk_reviews: Read customer reviews of a product (1-5 stars, newest first) with the store's replies and the star breakdown.
• mk_shipping: Get the nearest delivery slot and shipping fee for one product: Tehran courier and post to other cities.
• mk_branches: List MasterKala's physical shops in Tehran with address, phone and map location.

Rules

• Prices are Toman. Convert before comparing with a Rial figure from anywhere else.
• Read-only: no login, basket, booking, order or payment. Give the user the link to finish on the site.
• Keep request rates low. These are undocumented site APIs that can change or rate-limit.
• On timeouts or HTTP 403 outside Iran, set MASTERKALA_MCP_PROXY to an HTTP proxy with an Iranian IP.