Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
KASPI_DEFAULT_CITYNoDefault 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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 marketplace argument of other tools.

list_citiesA

List cities/towns supported by a marketplace, optionally filtered by a name fragment (Russian or English). Use it to find the right city value for the other tools.

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 filters to narrow the search. Pages are 0-based.

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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.2/5.0

Scored across 7 tools

Disambiguation5/5

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.

Naming Consistency5/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues