baneh-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BANEH_MCP_PROXY | No | HTTP proxy for every request to baaneeh.com, e.g. http://user:pass@host:port; a comma-separated list is used one at a time, moving on after a connect error. System proxy variables are ignored on purpose. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| bn_searchA | Search Baneh products by name in Persian or English, with price (Toman), stock and rating. Use to find products and their ids. A multi-word query must appear as a phrase in the title; for the lowest price of a product use bn_find_cheapest, which matches words in any order. Next: bn_product for one id. |
| bn_find_cheapestA | Find the cheapest products whose title contains every word of the query, one list sorted by price (Toman). Use for the lowest price of X. Words may come in any order. Raise min_price to skip accessories and spare parts. Items without a price are skipped. complete=false means more matches exist than were scanned (2,000 cap). Check bn_product before buying: the same title can be a different model or size. |
| bn_browseA | List products of a category and/or brand, optionally in a price range, sorted by price or rating. Use after bn_categories / bn_brands to see what a section holds, e.g. the cheapest in-stock LG TVs (category='tv', brand='lg', sort='cheapest'). Give at least one of category, brand or a price bound. |
| bn_categoriesA | List shop categories with slug and product count, biggest first. Without arguments returns the top-level sections. Use |
| bn_brandsA | List brands (about 150, e.g. LG, Samsung, Bosch, Xiaomi) with slug and product count, biggest first. Use to get the slug for bn_browse's |
| bn_productA | Get one product: price (Toman), stock, rating, brand, categories, spec attributes, highlights, description, images. Use after a search or browse to check details of one id. Variable products list their variations (options only; the shop publishes no per-variation price or stock). Next: bn_reviews for buyer opinions. |
| bn_reviewsA | Get buyer reviews of one product, newest first: rating 1-5, author, date, text. Use to check quality or complaints. Many products carry one long generated 'summary of buyer opinions' by 'دیدگاه خریداران' instead of real reviews; treat those as marketing text. Dates are Gregorian. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
bn_search and bn_find_cheapest both find products by query and could be confused, but descriptions explicitly differentiate them (phrase match vs. any-order word match for cheapest). bn_browse overlaps with bn_search slightly but is clearly scoped to category/brand/price filtering, and the rest (categories, brands, product, reviews) are distinct.
All tools share a consistent bn_ prefix, but the suffixes mix verbs (search, browse, find_cheapest) with plain nouns (categories, brands, product, reviews). The pattern is still predictable and readable, so only a minor deviation from a strict verb_noun convention.
Seven tools is well-scoped for a product-discovery server: two search variants, browse, two taxonomy lookups, detail, and reviews. Each tool earns its place with no redundant filler.
The discovery lifecycle is covered: find (search/cheapest/browse), navigate (categories/brands), inspect (product), and validate quality (reviews). There is no cart/order or purchase tooling, but the descriptions imply buying happens elsewhere, so gaps are minor.