market-fiyati-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MARKET_FIYATI_MODE | No | Mode for the server. Use 'offline' to block all requests to the Market Fiyatı API. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| market_statusA | Report mode, network lock, supported endpoints and local limits. No network access. |
| market_get_categoriesB | Get hierarchical categories. query, parentId and flat are local filters. Use returned Turkish names for category searches. |
| market_list_marketsA | List market chains via /api/v1/categories. Experimental; live acceptance has returned HTTP 500. Optional, never a prerequisite for search or comparison. On 500 report unknown chain active status and do not retry. Not the product category tree. |
| market_find_nearby_depotsA | Find nearby physical branches using explicit coordinates and radius in km. Experimental. Response distance is meters; choose returned depot IDs for product queries. |
| market_search_productsA | Search products and facets, one zero-based page. Combine keywords with known API filters such as refined_volume_weight and order in one request. Explicit location and nonempty depots required. Follow market://guide to preserve alternatives and exact requirements; fuzzy search still needs result validation. |
| market_search_by_categoryA | Search using menu_category, main_category or sub_category Turkish names from the category tree. At least one nonempty category filter and explicit location/depots required. |
| market_get_productA | Get product by opaque string identity with identityType=id. Returns location-specific branch offers, promotional fields and indexTime. Barcode wire type is unverified. |
| market_find_similar_productsA | Find related products using exact product id and its title as keywords. Similarity is not equivalence: inspect title and package size. |
| market_find_alternativesB | Find substitutes at one market chain. Experimental. marketName must match each supplied depot ID prefix; provide original id and product title as keywords. |
| market_get_price_historyA | Get market price series for uniqueId and selected product depot IDs. Optional from/to (YYYY-MM-DD) filter locally; returns chronological series and change statistics. |
| market_sync_productsA | Fetch up to 100 product identities in one call for an explicitly requested refresh. Experimental. Never switch to this tool to bypass a basket budget or run large live tests. Emits identityType=id, pages=0, size=identities.length. No purchase or persistent basket mutation. |
| market_geocode_addressA | Find address suggestions. Experimental map API. Returns display_name and explicit latitude/longitude parsed from API tuple positions. |
| market_reverse_geocodeA | Resolve coordinates into address fields and display_name. Experimental map API. Uses capitalized Lat and Lon query parameters. |
| market_compare_product_offersA | Fetch one product and compare returned branch prices. Use when a detail lookup or refresh is needed; existing search offers can already answer price questions. Reports cheapest branches, price spread and promotional fields. Zero prices are unavailable; percentage is not a discount. |
| market_compare_basketA | Compare exact product IDs and pack quantities via individual product lookups within market_status limits.basketItems and limits.basketRequestBudget, including retries. Over-budget calls are rejected before fetching. Never split the list or switch tools to bypass the budget; ask the user to narrow the comparison. Reuse sufficient search offers instead of redundant lookups. Present complete groups first and show all groups tied at the lowest total. groupBy=market may span branches; check selected offer depot IDs and requiresMultipleDepots before claiming one physical shop. depot means one physical shop. Present splitBasket as a saving only when complete and strictly cheaper than the stated complete basket baseline; follow market://guide for missing groups and equal totals. Incomplete totals are null. No automatic substitutes or purchases. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| compare_shopping_list | Resolve an exact shopping list and compare complete baskets with explicit location and depot selection. |
| find_best_product_price | Find exact matches and explained alternatives with API filters, minimizing calls and retaining freshness and promotion caveats. |
| analyze_price_history | Analyze historical market series without assuming unobserved depot aggregation rules. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| usage-guide | Workflow, price semantics and API limitations. |
| endpoint-catalog | Allowlisted API routes, experimental flags and unsupported operations. |
| runtime-status | Current mode and limits; performs no network operation. |
TDQS
Scored across 15 tools
Most tools target distinct operations, but boundaries blur between similar products, alternatives, search, and product offer comparison. market_find_similar_products and market_find_alternatives are semantically close, and market_compare_product_offers overlaps with market_get_product's branch offers.
The market_ prefix and verb_noun pattern are consistent across nearly all tools, e.g. search_products, get_price_history, compare_basket. Minor deviations like market_status and reverse_geocode slightly break the pattern but do not cause confusion.
15 tools is within the upper end of a reasonable scope for a price-comparison server covering search, categories, locations, history, and basket comparison. A few tools feel optional or redundant, such as market_list_markets and market_compare_product_offers, so the set is slightly heavy but still justified.
The surface covers the core lifecycle of market price discovery well: geocoding, nearby depots, category exploration, product search, detail lookup, history, and basket comparison. Minor gaps exist, such as no dedicated depot detail endpoint and barcode lookup being unverified, but agents can work around them.