io.github.mohammad-abbasi-sh/bonbama-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Unofficial read-only MCP server for bonbama.ir — Gorgan's discount platform: local businesses, discount codes and campaigns, business categories, and magazine articles. All data is read live from bonbama.ir public pages at call time; codes, prices and expiries change, so always report the fetched_at time and tell the user to verify on the business page before buying. Discount codes shown come from the business page text; some campaigns need the user to press «دریافت کد» on bonbama.ir (free, needs a free account) to generate their personal code/QR. Built by Mohammad Abbasi (mohammad-abbasi-sh) — https://almanibama.ir · https://mabbasi.ir
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
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| bb_search_businessesA | Search Bonbama businesses by keyword and/or category. query: Persian/English keyword (e.g. "ناخن", "testino"). category: a category slug from bb_list_categories (e.g. "zban", "rstoran"). Give at least one of query/category. Returns name, URL, slug and active-campaign count per business. |
| bb_get_businessA | Full details for one business: name, description, city, address, rating, category, ACTIVE campaigns (title, discount, expiry — read live from the page) and any literal discount codes published on the page. slug: e.g. "testino", "takchh" (from bb_search_businesses). |
| bb_list_categoriesA | All Bonbama business categories with Persian names and (where the homepage publishes them) business/campaign counts. Use the slug with bb_search_businesses(category=...). |
| bb_search_discountsA | Search ACTIVE discount campaigns site-wide by keyword (e.g. "کفش", "شهربازی"). With no query, returns current popular campaigns. Each result: business, campaign title, discount, Jalali expiry, campaign URL and how many codes were sent. |
| bb_search_articlesA | Search the Bonbama magazine (buying guides, discount explainers, best-of-Gorgan lists). query: Persian/English keyword. Matches article titles on the latest index pages and URL slugs. |
| bb_healthA | Check whether bonbama.ir is reachable right now. Returns status ok (HTTP 200), blocked (HTTP 403/429 — bot wall or rate limit) or error, plus the HTTP status and the probed URL. One polite request; it does not fetch any listings. |
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 6 tools
Each tool targets a distinct entity and action: business search vs. single-business detail vs. category listing vs. discount search vs. article search vs. health probe. The inclusion of the category-listing tool explicitly feeding the search tool's category parameter further separates the roles. No two tools could be reasonably confused for one another.
A consistent bb_ prefix plus verb_noun pattern (search_businesses, get_business, list_categories, search_discounts, search_articles) is applied throughout. The only deviation is bb_health, a bare noun rather than a verb_noun form, but it is still predictable and readable.
Six tools is a tight, well-scoped surface for a site-search server covering two content types (businesses, discounts) plus articles and categories. Every tool earns its place, with no redundant or filler operations.
The lifecycle is largely covered: discover categories, search businesses, fetch business detail (including its campaigns), search discounts, search articles, and verify reachability. Minor gaps exist — there is no direct single-campaign or single-article fetch, and no explicit city filter — but campaign and article data surface through the search and detail responses, so agents can work around it.