Skip to main content
Glama
serbia-prices-mcp

serbia-prices-mcp

by moskrc

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
SERBIA_PRICES_MCP_HOSTNoHTTP address host.127.0.0.1
SERBIA_PRICES_MCP_PORTNoHTTP address port.8000
SERBIA_PRICES_MCP_DATA_DIRNoDirectory for `prices.duckdb`.~/.cache/serbia-prices-mcp
SERBIA_PRICES_MCP_LOG_LEVELNoLog level; logs go to stderr.INFO
SERBIA_PRICES_MCP_TRANSPORTNoTransport mode; `http` serves Streamable HTTP at `/mcp`.stdio

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Grocery prices of the major retail chains of Belgrade and Novi Sad (Lidl, Maxi, Mega Maxi, Shop&Go, Idea, Mercator, Roda, Univerexport, Gomex, Aman, Metro, dm, Aroma, Svetofor, Veropoulos) from official open data at data.gov.rs, updated daily. Prices are in RSD. Product names in the data are Serbian (Latin script). Always translate the user's product words from any language into Serbian Latin before calling a tool, e.g. 'куриное филе' / 'chicken breast' -> 'pileci file', 'масло сливочное' / 'butter' -> 'maslac', 'яйца' / 'eggs' -> 'jaja', 'рис' / 'rice' -> 'pirinac'. Lists are paged: 'total' is the number of all results, pass 'offset' to get the next page. When answering, name the source: price lists published by the chains on data.gov.rs (Serbian Open Data License), with the price date; prices are shown as published and may differ in the store.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

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

Tools

Functions exposed to the LLM to take actions

NameDescription
search_productsA

Search current product prices across Serbian chains. Pass the product name in Serbian Latin (translate from Russian/English first) and optionally synonyms as extra list items. Most relevant names first, then the cheapest shelf price (price of the package as sold). If nothing is found, retry with a synonym or a more general word. Pass ean instead of query to compare one exact product across all chains and store formats: results are sorted by price, diff_rsd and diff_pct show the difference from the cheapest.

optimize_basketA

Estimate grocery basket cost per store. Each item has a Serbian Latin query and the number of packages, e.g. {'query': 'jaja', 'quantity': 1}. Without ean, every store gets the cheapest package whose name matches, which may be a different product (chocolate milk for 'mleko'). For an exact product, first find it with search_products, let the user choose, then pass its ean: {'query': 'mleko 2.8% 1l', 'ean': '860...', 'quantity': 2}. Cost is price x quantity; stores with all items come first.

get_top_discountsA

Current promotions with discount of at least min_discount_pct, as published by the chains. regular_raised_before_promo=true means the regular price was raised compared to the monthly snapshots of recent months, so the discount may be inflated; false does NOT confirm the discount is real. needs_verification=true marks discounts of 80% or more: usually clearance of leftover stock or a data error in the published price list; warn the user to check in the store.

get_price_historyA

Price history of a product by EAN from the price lists on data.gov.rs: monthly snapshots published by the chains (snapshot='monthly') and today's list (snapshot='current').

list_retailers_and_categoriesA

List available chains, their store formats, data dates and the 25 product categories.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4/5.0

Scored across 5 tools

Disambiguation5/5

Each tool has a distinct role: searching products, estimating a basket, listing retailers/categories, retrieving promotions, and fetching price history. The overlap between search_products and get_price_history is clearly separated by current prices vs. historical snapshots, and EAN usage is explained.

Naming Consistency5/5

All tool names follow a consistent snake_case verb_noun pattern: optimize_basket, search_products, list_retailers_and_categories, get_top_discounts, get_price_history. The one compound name is still readable and predictable.

Tool Count5/5

Five tools are well-scoped for a grocery price comparison server. Each tool covers a distinct workflow: discovery, search, basket estimation, promotions, and history, with no unnecessary filler.

Completeness4/5

The surface covers core price comparison workflows: current search, exact-product comparison via EAN, basket costing, retailer metadata, discounts, and history. Minor gaps exist, such as no explicit product-detail endpoint or category-filtered search, but agents can work around these using existing tools.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues