For AI agents

• What: unofficial MCP server for Baneh (baaneeh.com, بانه), an Iranian shop for home appliances, TVs, tools and car audio. Queries work in Persian and English; prices are in Toman.
• Install: claude mcp add baneh -- uvx baneh-mcp (stdio transport, needs uv and Python 3.10+).
• Auth: none. Optional BANEH_MCP_PROXY sets an HTTP proxy for requests to baaneeh.com.
• Access: read-only. No login, cart, orders or posted reviews, so no write tools exist.
• Tools: 7, all prefixed bn_. Start with bn_find_cheapest or bn_search. Typical sequence: bn_find_cheapest → bn_product → bn_reviews.
• Use when: comparing prices, stock and reviews of TVs, fridges, washing machines, kitchen appliances and tools on Baneh.
• Do not use when: the user wants to buy (no cart or checkout), wants phones (almost all are discontinued), or wants discounts (nothing in stock is discounted).
• Output: compact JSON. final_price is Toman. Null fields are left out: no regular_price means no discount, no rating means no reviews.
• Machine-readable: server.json, and the catalog of all Iranian MCP servers at awesome-iran-mcp.

Quick start

You need uv. No API key or account.

claude mcp add baneh -- uvx baneh-mcp

Claude Desktop, Cursor and others take the same command in their MCP config:

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

Then ask:

• "Cheapest in-stock Samsung TV above 20 million Toman?"
• "Show LG washing machines sorted by price, and the reviews of the cheapest one."
• ارزان‌ترین یخچال ساید بای ساید موجود در بانه کدام است؟

How it works

  AI agent  ──MCP over stdio──▶  baneh-mcp (your machine)  ──HTTPS──▶  baaneeh.com  (WooCommerce Store API)

It calls the public WooCommerce Store API that the website itself exposes. No hosted server, no API key.

Tools

All 7 tools are annotated readOnlyHint: true and return compact JSON.

Good to know

• In stock only by default. The catalog lists about 9,200 products but only about 1,900 are in stock. The rest, almost all of the phones and tablets, are discontinued and their prices are stale. Pass in_stock_only: false to include them.
• Sorting is done by the server of this tool, not the shop, which ignores sort parameters. Price and rating sorts scan up to 2,000 matches (about 5 s per 100); the reply shows scanned. A whole-shop price sort takes about 30 s the first time.
• No deals tool: no in-stock product has a sale price.
• Prices are the shop's own Toman amounts. A few look wrong (a USB cable at 144 million Toman); check the product page before relying on extremes.
• Reviews: many products carry one long generated "summary of buyer opinions" instead of real reviews.
• Shipping fees and policies are not available through the public API.

FAQ

npx @modelcontextprotocol/inspector uvx baneh-mcp

Configuration

فارسی: سرور MCP بانه

Development

git clone https://github.com/sepehr071/baneh-mcp && cd baneh-mcp
uv sync
uv run python -m pytest            # offline, against recorded responses
uv run python -m pytest -m live    # real baaneeh.com
uv run ruff check .

Tools live in src/baneh_mcp/catalog.py and product.py; each is a typed async function with a docstring that tells the agent when to use it.

Related servers

• Asal Banoo MCP server for cosmetics and skin care
• All Iranian MCP servers: awesome-iran-mcp

Disclaimer

Unofficial and not affiliated with or endorsed by Baneh. It uses the public API of the baaneeh.com website, which can change without notice. Please keep request rates reasonable.

License

MIT