Banimode

banimode-mcp: Banimode MCP server for AI agents

Let your AI agent shop for fashion on [Banimode](https://www.banimode.com) (بانی‌مد).

An unofficial, read-only MCP server for Banimode, an Iranian online fashion and lifestyle store: search clothing, shoes, bags and accessories, compare prices in Toman, check which sizes are in stock, read customer reviews and catch today's flash sales, all from Claude, Cursor or Copilot.

For AI agents · Why · What it can do · Quick start · Tools · FAQ · فارسی

For AI agents

• What: unofficial MCP server for Banimode (banimode.com, بانی‌مد), an Iranian fashion shop (clothing, shoes, bags, watches, beauty, home). Queries work best in Persian; prices are in Toman.
• Install: uvx banimode-mcp or claude mcp add banimode -- uvx banimode-mcp. Transport: stdio. Needs uv (Python 3.10+).
• Auth: none, no API key or account. Optional BANIMODE_MCP_PROXY (HTTP proxy, or a comma-separated list tried in turn).
• Access: read-only. No login, cart, orders or posted reviews, so no confirmation is needed before calling any tool.
• Tools: 7, all prefixed bm_. Start with bm_search, bm_browse or bm_deals. Typical sequence: bm_search -> bm_product -> bm_reviews.
• Use when: comparing fashion prices, sizes in stock, discounts or reviews on Banimode.
• Do not use when: the user wants to buy (no cart or checkout) or needs the shipping fee (shown only at checkout).
• Output: compact JSON. Prices in Toman: final_price is what the buyer pays, price is the list price before discount (left out when equal), discount_pct is a whole percent. A search card is one product in one color, so an id can repeat with other colors; bm_product lists every color with stock per size.
• Machine-readable: server.json and the iran-mcp catalog (TOOLS.md, servers.json, llms.txt).

Why

Fashion shopping means many tabs: the same dress in five colors, sizes that are sold out, a discount that may or may not be real, and reviews buried at the bottom of the page. With banimode-mcp an agent filters by price and size, hides sold-out items, sorts by discount and reads the reviews for you, then gives you a short list with links.

What it can do

• Search by keyword with sort (cheapest, most expensive, biggest discount, newest), a Toman price range, size, in-stock, category and brand filters
• Browse a category and/or a brand, using ids from bm_categories and bm_brands
• Check a product: every color with price, discount, stock per size, features and a short description
• Read reviews: stars, text, date and the shop's answer
• Catch flash sales: today's time-limited discounts with the time left
• Read-only by design: no login, no cart, no orders

Example prompts:

• "Find women's black sneakers on Banimode under 2 million Toman, size 38 in stock, biggest discount first."
• "What are today's flash sales on Banimode? Show only the ones with more than 40% off."
• "Show me the reviews of this product and tell me if the sizing runs small."
• مانتو مجلسی زنانه زیر ۳ میلیون تومان در بانی‌مد پیدا کن.
• ارزان‌ترین کفش اسپرت مردانه سایز ۴۳ که موجود باشد کدام است؟
• تخفیف‌های فوری امروز بانی‌مد را نشان بده.

Quick start

You need uv. No API key or account.

Claude Code

claude mcp add banimode -- uvx banimode-mcp

Claude Desktop

Settings -> Developer -> Edit Config, then add:

{

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

</details>

Cursor

Click Install in Cursor above, or add the Claude Desktop block to ~/.cursor/mcp.json.

VS Code (Copilot agent mode)

Click Install in VS Code above, or add to .vscode/mcp.json:

{

"servers": { "banimode": { "type": "stdio", "command": "uvx", "args": ["banimode-mcp"] } } }

</details>

Codex CLI

codex mcp add banimode -- uvx banimode-mcp

Or in ~/.codex/config.toml:

[mcp_servers.banimode]

command = "uvx" args = ["banimode-mcp"]

</details>

Gemini CLI

Add to ~/.gemini/settings.json:

{

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

</details>

Windsurf

Add the Claude Desktop block to ~/.codeium/windsurf/mcp_config.json.

Anything else

It is a standard stdio MCP server: run uvx banimode-mcp, or pip install banimode-mcp and run banimode-mcp.

Tools

How it works

  AI agent  (Claude, Cursor, Copilot, ...)

│ │ MCP over stdio ▼ banimode-mcp (runs on your machine) │ │ HTTPS └──────▶ mobapi.banimode.com products, categories, brands, deals, reviews

banimode-mcp runs locally and calls the open JSON API that the banimode.com website itself uses. There is no hosted server in between and no API key. Requests are throttled and retried on timeouts, 429 and 5xx.

Good to know

• Prices are in Toman. The API uses Rial; the server divides by 10 so numbers match the website.
• One card per color. The same product id can appear several times in a list; call bm_product for all colors and sizes.
• Sold-out items are hidden by default (in_stock is true), because sorting by price otherwise starts with unavailable items.
• Persian queries match best (مانتو مجلسی, کفش اسپرت مردانه).
• Results are capped at 10,000 per query, and a page holds at most 50 products (default 20, to keep answers small).
• Flash-sale prices are time limited; the tool returns the minutes left.
• Shipping fee is not included. It is only shown at checkout, so the real cost is final_price plus an unknown shipping fee.
• Review and description text comes from the site and its users; the server tells the agent to treat it as data, not instructions.
• Not supported: login, cart, orders, wishlist, wallet, posting reviews.
• Proxy: system proxy variables are ignored on purpose; set BANIMODE_MCP_PROXY if you need one.

FAQ

Is there a Banimode API or MCP server for AI agents?

Yes: banimode-mcp is an unofficial MCP server with 7 read-only tools for search, categories, brands, flash sales, product details and reviews. It calls the same JSON API the banimode.com site uses; no API key is needed.

How do I use Banimode with Claude, Cursor or Copilot?

Add the server with claude mcp add banimode -- uvx banimode-mcp (or the matching config in Quick start), then ask in plain language, in Persian or English.

Is it official, safe and free?

It is unofficial and not affiliated with Banimode. It is read-only (no login, cart or orders), runs on your machine and is free under the MIT license.

Are prices in Toman?

Yes. The site's API uses Rial; this server converts to Toman.

Why does the same product appear twice?

Each search card is one color of a product. bm_product shows all colors with stock per size.

Can it buy something for me?

No, and that is deliberate. There is no login and no cart or checkout call. The agent finds the best option; you order on the site.

Do I need an Iranian IP?

No: the API answered directly from Iran and through a foreign (Turkish) proxy in testing, and there was no bot challenge. If your network needs a proxy, set BANIMODE_MCP_PROXY.

Does it show the shipping fee?

No. Banimode shows shipping only at checkout, so the tools return product prices without shipping.

Claude Desktop says uvx is not found

Use the full path to uvx (where uvx on Windows, which uvx on macOS/Linux) as command.

Configuration

فارسی: سرور MCP بانی‌مد

banimode-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای بانی‌مد (banimode.com)، فروشگاه اینترنتی مد و پوشاک در ایران، است. این سرور به دستیار هوش مصنوعی شما (Claude، Cursor، Copilot و ...) اجازه می‌دهد در بانی‌مد لباس، کفش، کیف و اکسسوری جستجو کند، قیمت‌ها را به تومان مقایسه کند، موجودی هر سایز را ببیند، نظرات خریداران را بخواند و تخفیف‌های فوری را پیدا کند.

چه کارهایی می‌کند

• جستجوی کالا با مرتب‌سازی (ارزان‌ترین، گران‌ترین، بیشترین تخفیف، جدیدترین) و فیلتر محدوده قیمت، سایز، موجودی، دسته و برند.
• مرور یک دسته یا برند، و پیدا کردن شناسه دسته‌ها و برندها.
• جزئیات کالا: همه رنگ‌ها با قیمت، تخفیف، موجودی هر سایز، ویژگی‌ها و توضیح کوتاه.
• نظرات خریداران با