yerke-shops-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KASPI_DEFAULT_CITY | No | Default city used by Kaspi marketplace tools when no city is specified. If unset, defaults to Павлодар. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Read-only browsing of online marketplaces: search products, read details, seller prices, reviews and photos. This server cannot buy, order, add to cart or post reviews. Start with list_marketplaces, then pass the chosen marketplace id to the other tools. Product ids come from search_products.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_marketplacesA | List all supported online marketplaces with a short description of each (country, currency, languages, whether prices depend on city, supported sort options). Use the returned id as the |
| list_citiesA | List cities/towns supported by a marketplace, optionally filtered by a name fragment (Russian or English). Use it to find the right |
| search_productsA | Search a marketplace for products by text and/or filters. Returns product cards (id, title, lowest price, rating, review count, link), the total count, and on request the available categories and facets whose value ids can be passed back in |
| get_productA | Read one product: title, category, description, full specifications, photo count and link. For prices use get_product_offers, for photos get_product_photos, for reviews get_product_reviews. |
| get_product_offersA | List seller offers for a product in a city, cheapest first: seller, seller rating, price and delivery options. An empty list means the product is not available in that city. |
| get_product_reviewsA | Read customer reviews of a product: rating summary plus review texts, pros/cons, helpful votes and links to customer photos. Filter by ALL, COMMENT (with text), PICTURE (with photos), POSITIVE or NEGATIVE. |
| get_product_photosA | Get the product's gallery photos. Returns the photo URLs and, by default, the images themselves so they can be looked at directly. Set include_images=false to get only URLs. |
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
Each tool targets a distinct resource: marketplace listing, city lookup, search, and three non-overlapping product sub-resources (offers, reviews, photos). Descriptions explicitly cross-reference siblings (e.g. get_product says to use get_product_offers for prices), eliminating guesswork between similar-sounding get_product_* tools.
Uniform snake_case verb_noun pattern throughout: list_marketplaces, list_cities, search_products, get_product, get_product_offers, get_product_reviews, get_product_photos. The get_product_* prefix cleanly groups the product sub-resources without ambiguity.
Seven tools is well within the ideal range and each earns its place, covering discovery, search, and the distinct facets of a product page. No redundant or filler tools are present.
The surface covers the full browsing lifecycle: marketplace/city resolution, filtered search with facets, product detail, offers/pricing, reviews, and photos. Minor gaps exist (no standalone category browsing or seller lookup, and no comparison tool), but search returns categories and facets so agents can work around them.