MasterKala MCP server

<!-- mcp-name: io.github.sepehr071/masterkala-mcp -->

🎧 masterkala-mcp

Let your AI agent shop for gadgets on MasterKala. Search earbuds, chargers, power banks and smart watches, compare real prices and specs, read reviews, check stock and delivery dates, and catch today's discounts, all from Claude, Cursor or Copilot.

Quick start · What it can do · Tools · FAQ · فارسی

Why

MasterKala lists thousands of accessories, and a search for "power bank" mixes real power banks with silicone covers, out-of-stock items and things sold only in its shops. Finding the cheapest one you can actually order, and what it costs delivered, means paging through results and opening product pages. An agent with masterkala-mcp does that in seconds:

You: Cheapest Xiaomi power bank I can order now, delivered in Tehran?

Agent: calls mkfindcheapest(query="پاوربانک شیائومی") → mkshipping(productid=26935)

| Total | Product | Price | Shipping |

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

| 4,338,000 | پاوربانک 10000 شیائومی گلوریمی Glorimi LightCore 22.5W | 4,188,000 (5% off) | 150,000, Saturday 15:00-18:00 |

| 5,291,000 | پاوربانک فوق نازک مگنتی 5000 Glorimi FitCore Mag 20W | 5,291,000 (4% off) | free (over 5M) |

| 5,401,000 | پاوربانک 20000 شیائومی گلوریمی Glorimi LightCore 22.5W | 5,401,000 (6% off) | free (over 5M) |

The 10,000 mAh LightCore is cheapest even with the 150,000 courier fee. The 20,000 mAh LightCore ships

free and costs 1,063,000 more for twice the capacity. Want me to compare their specs with mk_specs?

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

What it can do

• 🔎 Search products by name in Persian or English, with price, discount and stock
• 💸 Find the cheapest in-stock match, with cases and covers filtered out
• 🗂️ Browse any category, brand or tag sorted by price, stock or date, with price range and brand/color filters
• 📋 Read full product details: colors, stock count, specs, side-by-side comparison, reviews
• 🚚 Check delivery: next Tehran courier slot, post to other cities, shipping fee, same-day cut-off
• ⚡ Catch deals on the discount page, plus buying guides from the MasterKala blog
• 🔒 Read-only by design: no login, no cart, no orders, no reviews posted

Quick start

You need uv. No API key or account.

Claude Code

claude mcp add masterkala -- uvx masterkala-mcp

Claude Desktop

Settings → Developer → Edit Config, then add:

Shortened. The full README is on GitHub.