ŞOK Grocery

io.github.mohammad-abbasi-shPublished by GitHub account mohammad-abbasi-shv0.1.1Updated Nov 11, 2026

Unofficial read-only MCP server for ŞOK grocery — products, categories, campaigns, prices.

VerifiedSTDIODesktop onlyBusiness & Commerce

Overview

ŞOK Grocery's local MCP server; no sign-in required; STDIO.

No AI overview yet: these facts come from the registry entry and the server itself.

Installation

In SourceWeft

  1. Open ŞOK Grocery in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

sok-mcp 🇹🇷

mcp-name: io.github.mohammad-abbasi-sh/sok-mcp

Unofficial read-only MCP server for ŞOK (sokmarket.com.tr) — one of Türkiye's big discount grocery chains: product search, product details, categories, campaign groups and price statistics.

Part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with ŞOK.

For AI agents

Add to your MCP client config (stdio):

json
{  "mcpServers": {    "sok": {      "command": "uvx",      "args": ["sok-mcp==0.1.1"]    }  }}

Or run locally: python -m sok_mcp.server (needs mcp<2, curl-cffi, requests).

Tools

ToolDescription
sok_search_productsSearch products by name — query, limit (1..30, first page only)
sok_get_productProduct detail — slug_or_url (e.g. ...-p-320230 or a full sokmarket.com.tr URL)
sok_list_categoriesStore categories (name, slug, id, url)
sok_category_productsProducts in one category — category slug or URL, limit (1..30)
sok_list_promotionsCurrent campaign groups from /kampanyalar
sok_price_statsPrice stats for a search — count, min, max, median, mean in TRY

Example output (sok_search_products / "süt"):

json
{"query": "süt", "total": 207, "products": [{"title": "Mis Uht Süt Yarım Yağlı 1 L", "id": "5834",   "url": "https://www.sokmarket.com.tr/mis-uht-sut-yarim-yagli-1-l-p-5834",   "price_try": 43.5}]}

Example output (sok_price_stats / "süt", first page of 10):

json
{"query": "süt", "total_matches": 207, "count": 10, "min_try": 16.5, "max_try": 88.5, "median_try": 55.75, "mean_try": 52.05}

Notes:

  • Prices are Turkish Lira (TRY); the site writes them Turkish-style (43,50₺).
  • Search/category pages return the first page (~20 products); total reports all matches.
  • Data: sokmarket.com.tr public server-rendered pages — no key, no login, read-only.

Development

bash
python3 -m venv .venv && .venv/bin/pip install "mcp<2" curl-cffi requests pytest.venv/bin/python -m pytest tests/ -q
  • tests/test_products.py — offline, parses real captured fixtures
  • tests/test_live.py — 5 cautious live requests against sokmarket.com.tr

License

MIT

Built by Mohammad Abbasi — Almanibama · mabbasi.ir

Source: README.md at commit 39ae1f7

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestNov 11, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.