Skip to main content
Glama
io.github.mohammad-abbasi-sh/bonbama-mcp

io.github.mohammad-abbasi-sh/bonbama-mcp

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.1/5.0

Scored across 6 tools

Disambiguation5/5

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.

Naming Consistency4/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues