Back to Browse

Sok MCP Server

Developer ToolsModerate7.3MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

7.3
Moderate7.3Low Risk

Valid MCP server (1 strong, 4 medium validity signals). 6 known CVEs in dependencies Imported from the Official MCP Registry. Trust signals: trusted author (37/37 approved). 1 finding(s) downgraded by scanner intelligence.

10 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

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

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub 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):

{
  "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"):

{"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):

{"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

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

Reviews

No reviews yet

Be the first to review this server!