{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_esycet39ea8r","handle":"sok-mcp","url":"https://wellknown.network/agents/sok-mcp","links":{"self":"https://wellknown.network/agents/sok-mcp/record.json","html":"https://wellknown.network/agents/sok-mcp","markdown":"https://wellknown.network/agents/sok-mcp/record.md","api":"https://wellknown.network/api/v1/agents/sok-mcp","status":"https://wellknown.network/api/v1/agents/sok-mcp/status","claim":"https://wellknown.network/agents/sok-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/sok-mcp/claim.json","badge":"https://wellknown.network/agents/sok-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/sok-mcp/history","tools":"https://wellknown.network/api/v1/agents/sok-mcp/tools"},"ard":{"identifier":"urn:air::server:sok-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"sok-mcp","summary":"Unofficial read-only MCP server for ŞOK grocery (sokmarket.com.tr) products, categories, campaigns, prices","description":"# sok-mcp 🇹🇷\n\nmcp-name: io.github.mohammad-abbasi-sh/sok-mcp\n\nUnofficial **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.\n\n> Part of the \"Turkey MCP factory\" (Sepehr-style pipeline). Not affiliated with ŞOK.\n\n## For AI agents\n\nAdd to your MCP client config (stdio):\n\n```json\n{\n  \"mcpServers\": {\n    \"sok\": {\n      \"command\": \"uvx\",\n      \"args\": [\"sok-mcp\"]\n    }\n  }\n}\n```\n\nOr run locally: `python -m sok_mcp.server` (needs `mcp<2`, `curl-cffi`, `requests`).\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `sok_search_products` | Search products by name — `query`, `limit` (1..30, first page only) |\n| `sok_get_product` | Product detail — `slug_or_url` (e.g. `...-p-320230` or a full sokmarket.com.tr URL) |\n| `sok_list_categories` | Store categories (name, slug, id, url) |\n| `sok_category_products` | Products in one category — `category` slug or URL, `limit` (1..30) |\n| `sok_list_promotions` | Current campaign groups from `/kampanyalar` |\n| `sok_price_stats` | Price stats for a search — count, min, max, median, mean in TRY |\n\nExample output (`sok_search_products` / \"süt\"):\n\n```json\n{\"query\": \"süt\", \"total\": 207,\n \"products\": [{\"title\": \"Mis Uht Süt Yarım Yağlı 1 L\", \"id\": \"5834\",\n   \"url\": \"https://www.sokmarket.com.tr/mis-uht-sut-yarim-yagli-1-l-p-5834\",\n   \"price_try\": 43.5}]}\n```\n\nExample output (`sok_price_stats` / \"süt\", first page of 10):\n\n```json\n{\"query\": \"süt\", \"total_matches\": 207, \"count\": 10,\n \"min_try\": 16.5, \"max_try\": 88.5, \"median_try\": 55.75, \"mean_try\": 52.05}\n```\n\nNotes:\n- Prices are Turkish Lira (TRY); the site writes them Turkish-style (`43,50₺`).\n- Search/category pages return the first page (~20 products); `total` reports all matches.\n- Data: sokmarket.com.tr public server-rendered pages — no key, no login, read-only.\n\n## Development\n\n```bash\npython3 -m venv .venv && .venv/bin/pip install \"mcp<2\" curl…","publisher":{"name":"Mohammad Abbasi","url":null},"homepage":null,"repository":null,"version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:sok-mcp","type":"package_pypi","auth":null,"probeable":false,"listed":true}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"commerce.ecommerce","name":"E-commerce Operations","confidence":0.791,"provenance":"derived"}],"categories":["commerce"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"sok-mcp","registry":"pypi","observedAt":"2026-11-10T03:26:43.247Z","publishedAt":"2026-11-08T15:50:20.993896Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"sok-mcp","url":"https://pypi.org/project/sok-mcp/","firstSeenAt":"2026-11-10T03:25:00.216Z","fetchedAt":"2026-11-10T03:25:00.216Z","normalizedAt":"2026-11-10T03:25:00.216Z"}]},"firstSeenAt":"2026-11-10T03:25:00.216Z","updatedAt":"2026-11-10T03:26:43.247Z"}