Skip to main content
Glama
Market Fiyatı MCP Server

Market Fiyatı MCP Server

Market Fiyatı MCP Server

PyPI version MCP Specification

An MCP server for marketfiyati.org.tr, a price comparison website for groceries in Turkey.

This server exposes the search functionality of the website as tools for MCP-compatible clients.

Features

  • Search Products: Find products using keywords.

  • Search by ID: Look up products by their unique ID or barcode.

  • Find Similar Products: Discover products similar to a given item.

Related MCP server: market-fiyatlari-mcp-server

Prerequisites

  • Python 3.12+

  • uv (recommended for project and virtual environment management)

Installation

  1. Clone the repository:

    git clone https://github.com/mtcnbzks/market-fiyati-mcp-server.git
    cd market-fiyati-mcp-server
  2. Create a virtual environment and install dependencies:

    uv venv
    uv sync

Usage

You can run this server and connect to it from any MCP-compatible client.

Running the Server

To start the server, run the following command in your terminal:

uv run python -m market_fiyati_mcp_server.server

The server will start and listen for connections from MCP clients.

Connecting from a Client

You can use the MCP development tools to inspect and interact with the server.

  • Install in an MCP Client (e.g., Claude Desktop): To make the server available in a client like the Claude Desktop App, you can install it using:

    uv run mcp install src/market_fiyati_mcp_server/server.py
  • Manual Configuration (e.g., VS Code): To add the server to a client that uses a mcp.json configuration file (like VS Code), add the following to the servers object in your mcp.json.

    {
      "servers": {
        "market-fiyati": {
          "command": "uvx",
          "args": ["market-fiyati-mcp-server"]
        }
      }
    }

Tools

This server provides the following tools:

search_product

Search for products matching given keywords.

  • Parameters:

    • keywords (str): The search terms.

    • latitude (float, optional): Latitude for location-based search.

    • longitude (float, optional): Longitude for location-based search.

    • distance (int, optional): Radius in km for location-based search.

  • Returns: A human-readable summary and the full structured API response.

search_product_by_identity

Retrieve product information by a unique identity (e.g., barcode or internal ID).

  • Parameters:

    • identity (str): The product's unique ID or barcode.

    • identityType (str, optional): The type of identity (id or barcode). Defaults to id.

    • keywords (str, optional): Optional keywords to refine the search.

    • latitude (float, optional): Latitude for location-based search.

    • longitude (float, optional): Longitude for location-based search.

    • distance (int, optional): Radius in km for location-based search.

  • Returns: A summary of the found product and the full structured API response.

search_similar_products

Find products similar to a reference item ID.

  • Parameters:

    • id (str): The ID of the reference product.

    • keywords (str): Keywords to find similar products.

    • latitude (float, optional): Latitude for location-based search.

    • longitude (float, optional): Longitude for location-based search.

    • distance (int, optional): Radius in km for location-based search.

  • Returns: A summary of the most similar product and the full structured API response.

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables searching and comparing product prices across Turkish supermarket chains (BIM, A101, Migros, SOK, etc.) with location-based filtering. Provides access to Turkish market data from marketfiyati.org.tr for price tracking and comparison.
      3
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables searching and comparing products from Woolworths and Coles supermarkets.
      MIT
    • 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