serbia-prices-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SERBIA_PRICES_MCP_HOST | No | HTTP address host. | 127.0.0.1 |
| SERBIA_PRICES_MCP_PORT | No | HTTP address port. | 8000 |
| SERBIA_PRICES_MCP_DATA_DIR | No | Directory for `prices.duckdb`. | ~/.cache/serbia-prices-mcp |
| SERBIA_PRICES_MCP_LOG_LEVEL | No | Log level; logs go to stderr. | INFO |
| SERBIA_PRICES_MCP_TRANSPORT | No | Transport 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
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.
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.
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.
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.