Skip to main content
Glama
Market Fiyatı MCP

Market Fiyatı MCP

by enesoglu

Market Fiyatı MCP

Grocery price tools for MCP-compatible AI clients.

CI Python 3.13+ License: MIT

Search Turkish grocery prices from Market Fiyatı using an AI agent or another Model Context Protocol client. The server is independent of the client's model and vendor.

Run it on Windows, macOS or Linux, in a container, or on a hosted container platform. Local use requires no account, domain, inbound port or cloud service.

Unofficial project, not affiliated with Market Fiyatı or its operators. Price availability, coverage and freshness depend on the upstream provider.

Choose your setup

Scenario

Transport / authentication

Guide

An agent runs on your computer

stdio; local process access

Local installation

A client needs a localhost URL

Streamable HTTP; loopback only

HTTP connections

An agent connects to another machine

HTTP with bearer token or OAuth

HTTP connections

You prefer Docker

stdio or HTTP; optional persistent OAuth state

Containers

A managed platform supplies an HTTPS URL

Stateless bearer HTTP; platform port

Cloud hosting

An LLM accesses these tools through an MCP client or agent framework. Compatibility depends on the client's transport and authentication support, not its model brand.

Related MCP server: Market Fiyatı MCP Server

Quick start

Python 3.13+:

git clone https://github.com/enesoglu/market-fiyati-mcp.git
cd market-fiyati-mcp
python -m pip install .
market-fiyati-mcp --client-config

Use a virtual environment for an isolated installation. The optional installers do that for you:

# Windows PowerShell
.\setup\install.ps1
# macOS / Linux
sh setup/install.sh

Both print the command that generates your local client configuration. See the local guide for configuration examples and installation from source.

Tools

Tool

Input

Result

search_products

Keywords; optional explicit location

Matching products and store offers

find_product

Provider product ID or barcode

Identity-based lookup

find_similar_products

Product ID and keywords

Provider-suggested alternatives

For example: “Süt 1 litre seçeneklerini ara; fiyatları miktarlarıyla birlikte karşılaştır.”

Location filtering takes latitude, longitude and radius in meters, supplied together. The server does not infer your location. Responses include:

  • Decimal TRY prices, package quantity/unit and store information.

  • UTC retrieval time, provider price timestamps and cache status.

  • Explicit result/offer truncation and provider-reported match counts.

The cheapest returned offers are sorted first. Alternatives are not exact matches, and provider prices are not checkout guarantees.

HTTP without a domain

For a client on the same computer:

market-fiyati-mcp --transport http

Connect to http://127.0.0.1:8000/mcp. This mode binds only to loopback and refuses a nonlocal unauthenticated configuration.

For a different machine, use an SSH connection/tunnel, an HTTPS-capable IP endpoint, or a hosting platform's supplied HTTPS URL. A custom domain is optional. Public HTTP must use bearer authentication or OAuth; see connection examples.

Design

flowchart LR
    A[MCP client / AI agent] --> B[stdio or Streamable HTTP]
    B --> C[Three read-only tools]
    C --> D[Bounded price client]
    D --> E[Market Fiyatı]
    D --- F[Short-lived memory cache]
  • Three fixed upstream operations; no arbitrary URL fetch or write tools.

  • Async requests, bounded cache/response sizes, timeouts and limited retries.

  • Provider failures remain explicit errors rather than empty search results.

  • Stateless bearer mode; persistent encrypted state only when OAuth is selected.

  • No application access logs containing searches, locations or credentials.

  • Tests cover real MCP handshakes, HTTP profiles, OAuth and provider failures.

Read Architecture, Configuration, Security and Contributing.

Limits

This server queries an undocumented upstream interface. It may change or rate limit requests. The project does not bypass provider restrictions, promise complete coverage, bulk export prices or create a historical price database.

The service is operator-managed, not a multi-user account platform. Bearer access is shared by clients holding that token; OAuth grants are individually revocable. Monitoring, TLS termination and backups belong to the chosen hosting environment.

Available Tools

3 tools
find_productA
Read-onlyIdempotent

Find by provider product ID or barcode. Set identity_type to id or barcode. A barcode match is distinct from fuzzy name similarity. Optional distance is in meters and requires latitude and longitude. Upstream errors are not empty results.

Inputs: identity (required), limit, distance, latitude, +2 more.

find_similar_productsB
Read-onlyIdempotent

Find provider-suggested alternatives to a provider product ID. Alternatives are not exact product matches. Compare quantities and units before comparing prices. Optional distance is in meters and requires both coordinates.

Inputs: keywords (required), product_id (required), limit, distance, +2 more.

search_productsA
Read-onlyIdempotent

Search Turkish grocery products. Optional location requires all three fields; distance is in meters (100–50000). Returns up to 25 products and 20 cheapest returned offers per product, TRY prices, provenance and truncation flags. Results are provider snapshots, not guaranteed checkout prices. Do not invent a location.

Inputs: keywords (required), limit, distance, latitude, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 3 tools

    Disambiguation5/5

    The three tools have clearly distinct purposes: text search, exact identity lookup by ID/barcode, and provider-suggested alternatives. The descriptions explicitly distinguish name similarity, barcode matching, and inexact alternatives, so an agent can select the right tool.

    Naming Consistency5/5

    All tool names follow a consistent snake_case verb_noun pattern: search_products, find_product, find_similar_products. The pluralization and verb choices are predictable.

    Tool Count5/5

    Three tools are well matched to this focused grocery product search and price lookup domain. Each tool covers a distinct operation without redundancy or an overly large surface.

    Completeness4/5

    The set covers the core workflows: searching by text, resolving a known product by ID/barcode, and discovering alternatives with offers. Minor gaps remain, such as broader browsing by category/provider or explicit pagination beyond the documented limits, but agents can work around them.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      B
      maintenance
      A Model Context Protocol server for real-time Swiss grocery shopping that searches and compares products across 8 major Swiss retailers (Migros, Coop, Aldi, Denner, Lidl, Farmy, Volgshop, Otto’s), normalizes per-unit prices, surfaces promotions, computes optimal multi-store shopping plans, and works with any MCP-compatible client without API keys or accounts.
      7
      255 npm
      44
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      An MCP server that provides a queryable, agent-native layer over Israeli supermarket price transparency feeds, enabling Hebrew product search, online delivery optimization, and cross-chain price comparison.
      1
      Apache 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables product search, store price comparison, basket comparison, and price history review using Market Fiyatı data through a stdio MCP server.
      15
      179 npm
      MIT