# Asal Banoo [Health: Active]

**Category:** 🛒 E-Commerce  
**Repository:** https://github.com/sepehr071/asalbanoo-mcp  
**GitHub Stars:** 2  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/asal-banoo

## Description
Unofficial read-only Asal Banoo: search cosmetics and skin care, compare prices, sizes, deals.

## Tools
Capabilities this server exposes over MCP:

- **ab_search** — Search by keyword: price, discount, stock, rating, with sort and price range
- **ab_find_cheapest** — Cheapest in-stock matches for a keyword, one flat list (titles must contain every word)
- **ab_browse** — A category, brand or the whole shop sorted by price / date / popularity / rating, with price range and filters
- **ab_filters** — Volume, hair/skin type, gender and origin filters of a category or brand, with counts
- **ab_categories** — Product categories with slugs and product counts
- **ab_brands** — Brands with slugs and product counts
- **ab_deals** — Everything discounted and in stock, biggest discount first
- **ab_product** — Price, discount, stock (exact count when low), every size/color variant, brand, rating, key facts
- **ab_reviews** — Customer reviews and questions with star breakdown and the shop's answers
- **ab_shop_info** — FAQ, terms, about and contact pages as text: delivery times, returns, wallet, branches
- **ab_blog_posts** — Skin and hair care guides and comparisons, newest first
- **ab_blog_post** — One guide as plain text, with the products and categories it links to

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "asal-banoo": {
    "command": "uvx",
    "args": ["asalbanoo-mcp"],
    "env": {
      "ASALBANOO_MCP_PROXY": ""
    }
  }
}
```

**Requires environment variables:** `ASALBANOO_MCP_PROXY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What the Asal Banoo MCP server does

The Asal Banoo MCP server gives an AI agent read-only access to product and informational content from Asal Banoo, an Iranian online shop at asalbanooshop.com. Its catalog covers skin care, hair care, make-up, and perfume. Queries can be made in Persian or English, and product prices are returned in Toman.

The server is suited to research and comparison workflows. An agent can look for a product, narrow results by price or stock, inspect variants, compare ratings, read customer feedback, and review current discounts. It can also retrieve shop policies and the store’s skin and hair care articles. It does not provide shopping actions: there are no login, cart, checkout, order, or review-posting tools.

## How it works

The Asal Banoo MCP server runs on the user’s machine and communicates with an MCP client through stdio. It then requests public pages and endpoints used by asalbanooshop.com over HTTPS. There is no hosted intermediary, API key, or account requirement described in the provided material.

A typical workflow starts with `ab_search`, `ab_find_cheapest`, or `ab_browse`. The agent can pass a returned product ID to `ab_product` for detailed pricing, stock, variants, and product facts, then use `ab_reviews` for customer reviews and questions. Results are returned as compact structured JSON. Search and catalog data can change, so prices and availability should be treated as current observations rather than permanent values.

## Setup and configuration

The package requires Python 3.10 or later and `uv`. The standard launch command is:

```bash
uvx asalbanoo-mcp
```

It can also be installed with `pip install asalbanoo-mcp` and run as `asalbanoo-mcp`. Claude Code can add it with `claude mcp add asalbanoo -- uvx asalbanoo-mcp`; Claude Desktop, Cursor, and VS Code can use the equivalent stdio configuration shown by the project.

No API key or account is needed. Set `ASALBANOO_MCP_PROXY` if requests to asalbanooshop.com must use an HTTP proxy.

## Tools and capabilities

The 12 tools are grouped around catalog discovery, product details, and shop content:

- `ab_search` searches by keyword with price, discount, stock, rating, sorting, and price-range options.
- `ab_find_cheapest` returns in-stock matches whose titles contain every query word, ordered as one flat list.
- `ab_browse` browses a category, brand, or the full shop with sorting and filters.
- `ab_filters`, `ab_categories`, and `ab_brands` expose available filters, category slugs, brand slugs, and product counts.
- `ab_deals` lists discounted, in-stock products with the largest discounts first.
- `ab_product` reports price, discount, stock, variants, brand, rating, and key facts.
- `ab_reviews` returns reviews, questions, star summaries, and shop responses.
- `ab_shop_info` provides FAQ, terms, delivery, returns, wallet, branch, about, and contact content.
- `ab_blog_posts` and `ab_blog_post` expose care guides, comparisons, linked products, and linked categories.

## Limitations and notes

The Asal Banoo MCP server is unofficial and read-only. It cannot purchase products, manage a cart, place orders, submit reviews, or authenticate a customer. Shipping fees are not available through the server because the shop shows them only at checkout. Availability, discounts, ratings, and prices may change on the source shop. Product-specific detail requests should use the product ID returned by `ab_search` or `ab_browse`.

_Full upstream README: https://allmcps.com/mcp/asal-banoo/readme_