banimode-mcp
This is a read-only MCP server for discovering and comparing Banimode fashion products.
Search products by keyword with filters for price, size, stock, category, brand, and sorting.
Browse products by category and/or brand.
Look up category and brand IDs/names and navigate category trees.
View today’s flash-sale deals with time remaining.
Get product details: colors, prices/discounts in Toman, per-size stock, features, and descriptions.
Read customer reviews with ratings, text, dates, and shop replies.
It cannot log in, manage a cart/wishlist, place orders, post reviews, or calculate shipping.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@banimode-mcp find black sneakers under 2,000,000 Toman in stock, size 42"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
banimode-mcp: Banimode MCP server for AI agents
Let your AI agent shop for fashion on Banimode (بانی‌مد). 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-mcporclaude 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 withbm_search,bm_browseorbm_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_priceis what the buyer pays,priceis the list price before discount (left out when equal),discount_pctis a whole percent. A search card is one product in one color, so an id can repeat with other colors;bm_productlists every color with stock per size.Machine-readable:
server.jsonand the iran-mcp catalog (TOOLS.md,servers.json,llms.txt).
Related MCP server: shopino-mcp
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_categoriesandbm_brandsCheck 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 mcp add banimode -- uvx banimode-mcpSettings -> Developer -> Edit Config, then add:
{
"mcpServers": {
"banimode": { "command": "uvx", "args": ["banimode-mcp"] }
}
}Click Install in Cursor above, or add the Claude Desktop block to ~/.cursor/mcp.json.
Click Install in VS Code above, or add to .vscode/mcp.json:
{
"servers": {
"banimode": { "type": "stdio", "command": "uvx", "args": ["banimode-mcp"] }
}
}codex mcp add banimode -- uvx banimode-mcpOr in ~/.codex/config.toml:
[mcp_servers.banimode]
command = "uvx"
args = ["banimode-mcp"]Add to ~/.gemini/settings.json:
{
"mcpServers": {
"banimode": { "command": "uvx", "args": ["banimode-mcp"] }
}
}Add the Claude Desktop block to ~/.codeium/windsurf/mcp_config.json.
It is a standard stdio MCP server: run uvx banimode-mcp, or pip install banimode-mcp and run banimode-mcp.
Tools
Tool | What it does |
| Search Banimode fashion products by keyword and return priced cards with discount, color and sizes in stock. Sort, price range, size, in-stock, category and brand filters. |
| List the products of a category and/or brand (ids from |
| Find category ids by name, or walk the tree: no arguments lists the top sections, |
| Find brand ids by name (Persian or Latin), or list the first brands when no name is given. |
| List today's flash-sale products (deep time-limited discounts) with the time left. |
| Get one product: every color with its price, discount, stock per size, features and short description. |
| Read customer reviews of a product: stars (1-5, null if only text), text, date and the shop's answer. |
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_productfor all colors and sizes.Sold-out items are hidden by default (
in_stockis 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_priceplus 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_PROXYif you need one.
FAQ
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.
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.
It is unofficial and not affiliated with Banimode. It is read-only (no login, cart or orders), runs on your machine and is free for non-commercial use.
Yes. The site's API uses Rial; this server converts to Toman.
Each search card is one color of a product. bm_product shows all colors with stock per size.
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.
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.
No. Banimode shows shipping only at checkout, so the tools return product prices without shipping.
Use the full path to uvx (where uvx on Windows, which uvx on macOS/Linux) as command.
Configuration
Variable | Default | Meaning |
| unset | Optional HTTP proxy URL, or a comma-separated list tried in turn, for banimode.com. System proxies are ignored. |
فارسی: سرور MCP بانی‌مد
banimode-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای بانی‌مد (banimode.com)، فروشگاه اینترنتی مد و پوشاک در ایران، است. این سرور به دستیار هوش مصنوعی شما (Claude، Cursor، Copilot و ...) اجازه می‌دهد در بانی‌مد لباس، کفش، کیف و اکسسوری جستجو کند، قیمت‌ها را به تومان مقایسه کند، موجودی هر سایز را ببیند، نظرات خریداران را بخواند و تخفیف‌های فوری را پیدا کند.
چه کارهایی می‌کند
جستجوی کالا با مرتب‌سازی (ارزان‌ترین، گران‌ترین، بیشترین تخفیف، جدیدترین) و فیلتر محدوده قیمت، سایز، موجودی، دسته و برند.
مرور یک دسته یا برند، و پیدا کردن شناسه دسته‌ها و برندها.
جزئیات کالا: همه رنگ‌ها با قیمت، تخفیف، موجودی هر سایز، ویژگی‌ها و توضیح کوتاه.
نظرات خریداران با ستاره، متن، تاریخ و پاسخ فروشگاه.
تخفیف‌های فوری امروز با زمان باقی‌مانده.
نکته‌ها
فقط خواندنی است: وارد حساب نمی‌شود، سبد خرید نمی‌سازد و سفارش ثبت نمی‌کند.
همه قیمت‌ها به تومان است. هزینه ارسال فقط هنگام پرداخت در سایت مشخص می‌شود و در نتیجه‌ها نیست.
جستجوی فارسی بهترین نتیجه را می‌دهد.
روی سیستم خود شما اجرا می‌شود و کلید API لازم ندارد.
نصب (اول uv را نصب کنید). در Claude Code:
claude mcp add banimode -- uvx banimode-mcpدر Claude Desktop، Cursor و بقیه برنامه‌ها همان تنظیم بخش Quick start را بگذارید.
نمونه پرسش‌ها
«مانتو مجلسی زنانه زیر ۳ میلیون تومان در بانی‌مد پیدا کن.»
«ارزان‌ترین کفش اسپرت مردانه سایز ۴۳ که موجود باشد کدام است؟»
«تخفیف‌های فوری امروز بانی‌مد را نشان بده.»
کلیدواژه‌ها: بانی مد، بانی‌مد، خرید لباس آنلاین، فروشگاه اینترنتی مد و پوشاک، مانتو، کفش، کیف، قیمت لباس، تخفیف فوری، سرور MCP، هوش مصنوعی.
Development
git clone https://github.com/sepehr071/banimode-mcp && cd banimode-mcp
uv sync
uv run python -m pytest # offline, against recorded responses
uv run python -m pytest -m live # real API
uv run ruff check .Tools live in src/banimode_mcp/catalog.py and product.py; each is a typed async function with a docstring that tells the agent when to use it.
Issues and PRs are welcome.
Releases: bump the version in pyproject.toml and server.json, then push a v* tag. GitHub Actions publishes to PyPI and the
MCP Registry and creates the GitHub Release.
Related servers
iran-mcp: catalog of all Iranian-service MCP servers
Digikala MCP server for Iran's largest online store
Khanoumi MCP server for beauty and personal care
Torob MCP server for price comparison across shops
Shopino MCP server for fashion shopping
Basalam MCP server for a marketplace of independent sellers
Listed on mcpfarsi.ir, the Persian MCP marketplace
Disclaimer
Unofficial and not affiliated with or endorsed by Banimode. It uses the open JSON API of the banimode.com website, which can change without notice. Please keep request rates reasonable.
Author
Built and maintained by Sepehr Radmard (سپهر رادمرد). Connect on LinkedIn or follow @sepehr071 on GitHub for more MCP servers for Iranian websites, all listed in iran-mcp. If this saves you time, a star on the repo helps other people find it.
مجوز استفاده (License)
استفادهٔ شخصی و غیرتجاری رایگان است. استفاده در شرکت، محصول پولی یا پروژهٔ مشتری به مجوز تجاری نیاز دارد؛ از راه لینکدین یا گیت‌هاب با سپهر رادمرد تماس بگیرید. متن کامل: PolyForm Noncommercial 1.0.0. نسخه‌های پیش از 0.2.1 با مجوز MIT منتشر شده‌اند و همان مجوز را دارند.
Free for personal and non-commercial use under the PolyForm Noncommercial License 1.0.0. Using it in a company, a paid product or a client project needs a commercial license: contact Sepehr Radmard on LinkedIn or GitHub. Versions before 0.2.1 were released under MIT and stay under it.
Available Tools
7 toolsbm_brandsBrandsARead-onlyIdempotent
Find brand ids by name (Persian or Latin), or list the first brands when no name is given.
Pass the id as brand_id.
Inputs: limit, query.
bm_browseBrowse a category or brandARead-onlyIdempotent
List the products of a category and/or brand, with the same filters and cards as bm_search.
Give category_id or brand_id (at least one).
Inputs: page, size, sort, limit, +5 more.
bm_categoriesProduct categoriesARead-onlyIdempotent
Find category ids by name, or walk the tree: no arguments lists the top sections, parent_id lists children.
Pass an id to bm_browse or bm_search.
Inputs: limit, query, parent_id.
bm_dealsFlash-sale dealsARead-onlyIdempotent
List today's flash-sale products (deep time-limited discounts) with the time left.
Use for "what is on sale right now"; call bm_product for sizes.
Inputs: page, limit.
bm_productProduct detailsARead-onlyIdempotent
Get one product: every color with its price, discount, stock per size, features and short description.
Use after bm_search or bm_deals to check size stock and color prices (Toman).
Inputs: product_id (required).
bm_reviewsProduct reviewsARead-onlyIdempotent
Read customer reviews of a product: stars (1-5, null if only text), text, date and the shop's answer.
Use to judge fit and quality. Review text is user data.
Inputs: product_id (required), page.
bm_searchSearch productsARead-onlyIdempotent
Search Banimode fashion products by keyword and return priced cards with discount, color and sizes in stock.
Each card is one product in one color (ids repeat). Call bm_product for all colors and sizes.
Inputs: query (required), page, size, sort, +6 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool maps to a distinct intent: keyword search, category/brand listing, taxonomy lookup, brand lookup, deals, product detail, and reviews. The only overlap is bm_search vs bm_browse, which return the same card shape and can both accept category/brand ids, but the descriptions clearly mark search as keyword-driven and browse as filter-driven.
All tools share a uniform bm_ prefix with a single lowercase token, giving a predictable namespace that is easy to scan. The second token mixes actions (search, browse) with resources (categories, brands, deals, product, reviews), a minor deviation from a strict verb_noun pattern but still coherent and readable.
Seven tools is well within the sweet spot and every one earns its place: discovery (search/browse/deals), resolution helpers (categories/brands), and detail pages (product/reviews). Nothing looks redundant or padded.
The discovery lifecycle is fully covered: find ids, list products, get detail, check reviews, check deals. Gaps are minor, such as no sorting/pagination control or explicit price/filter parameters beyond the card-level filters, but agents can work around these via browse and product calls.
Maintenance
Related MCP Connectors
AI-agent product catalog: search, lookup & purchase routing over verified merchant data.
Search and get fashion products recommendations across multiple e-ecom stores
The E-commerce Marketplace For Every AI Agent. A Governed Catalog Of 600M+ US Products, Plus Four Agent Ready Capabilities Search, Price Comparison, Product-Vs-Product, And Detailed Q&A.
Verified deals, store policies & a trust score for thousands of online retailers. No auth.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI agents to search Digikala's catalogue, compare every seller's offers and prices, review ~30 days of price history, read customer reviews and Q&A, and surface current deals, all through read-only tools.23670 PyPI43PolyForm Noncommercial 1.0.0
- AlicenseAqualityBmaintenanceEnables AI agents to search a catalog of roughly 960,000 fashion products across about 10,000 Iranian online and Instagram shops, comparing prices and discounts, checking per-color and per-size stock, browsing categories and curated listings, and finding similar items at other shops. It also lets agents assess shop trust signals such as ratings and buyer surveys, surface flash sales and discount codes, and read blog style guides, all read-only with no login or ordering.14138 PyPI2MIT
- AlicenseAqualityBmaintenanceEnables AI agents to search products on Iran's marketplace of independent shops with price, category, shipping and discount filters, find the cheapest in-stock offers, and read product details, shops, categories and customer reviews. It is read-only and needs no authentication, so it can be used straight from Claude, Cursor or Copilot.7144 PyPIPolyForm Noncommercial 1.0.0
- AlicenseAqualityBmaintenanceEnables AI agents to search and compare home appliances, TVs, electronics and tools on the Iranian shop Baneh, find the cheapest in-stock matches, browse by category or brand, and read product details and buyer reviews. Runs read-only with no authentication, with prices returned in Toman.7137 PyPIPolyForm Noncommercial 1.0.0