technolife-mcp
Advanced tools
Unofficial read-only MCP server for Technolife: search electronics, compare sellers and installment prices, find deals.
Let your AI agent shop around on Technolife (تکنولایف).
An unofficial, read-only MCP server for Technolife, the Iranian electronics store and marketplace:
search phones, laptops and appliances, compare every seller's cash and installment price, read specs and reviews, and catch today's deals, all from Claude, Cursor or Copilot.
For AI agents · Why · What it can do · Quick start · Tools · How it works · Good to know · FAQ · Configuration · فارسی · Development · Related servers
uvx technolife-mcp or claude mcp add technolife -- uvx technolife-mcp. Transport: stdio. Needs uv (Python 3.10+).TECHNOLIFE_MCP_PROXY (HTTP proxy, or a comma-separated list, for every request).tl_. Start with tl_find_cheapest, tl_search, tl_suggest, tl_deals.
Typical sequence: tl_suggest -> tl_product -> tl_price_basket.final_price after discount), ratings 0-5, review dates Jalali. Product codes like TLP-60492 and seller codes like TLS-15172 pass between tools.server.json and the
iran-mcp catalog (TOOLS.md, servers.json, llms.txt).On Technolife one product page hides several sellers, colors, warranties and three price lists
(cash, installment, buy now pay later). Finding the best offer means clicking through each of them.
An agent with technolife-mcp reads them all at once:
You: Where is the Lenovo IdeaPad Slim 3 i3 1315U cheapest on Technolife, and what does it cost in installments?
Agent: calls
tl_suggest(query="IdeaPad Slim 3 i3 1315U")→tl_product(product_code="TLP-60492")
Seller Cash Installment Buy now pay later Warranty ایران پشتیبان 125,000,000 128,750,000 135,000,000 18 months چیتک شاپ 129,500,000 133,385,000 139,860,000 18 months دیباکام 130,000,000 133,900,000 140,400,000 18 months (Dibacom) ایران پشتیبان is cheapest in every price list and ships the next working day; device insurance adds 2,375,000. Want me to check the exact total with insurance using
tl_price_basket?
Real tool output from 2026-10-03; prices change all the time. Prices are in Toman.
Example prompts:
You need uv. No API key or account.
claude mcp add technolife -- uvx technolife-mcp
Settings → Developer → Edit Config, then add:
{
"mcpServers": {
"technolife": { "command": "uvx", "args": ["technolife-mcp"] }
}
}
Click Install in Cursor above, or add the Claude Desktop block to ~/.cursor/mcp.json (or .cursor/mcp.json in a project).
Click Install in VS Code above, or add to .vscode/mcp.json:
{
"servers": {
"technolife": { "type": "stdio", "command": "uvx", "args": ["technolife-mcp"] }
}
}
codex mcp add technolife -- uvx technolife-mcp
Or in ~/.codex/config.toml:
[mcp_servers.technolife]
command = "uvx"
args = ["technolife-mcp"]
Add to ~/.gemini/settings.json:
{
"mcpServers": {
"technolife": { "command": "uvx", "args": ["technolife-mcp"] }
}
}
Add the Claude Desktop block to ~/.codeium/windsurf/mcp_config.json.
It is a standard stdio MCP server: run uvx technolife-mcp, or pip install technolife-mcp and run technolife-mcp.
Products are identified by codes like TLP-60492 and sellers by TLS-15172. List tools return the
site's featured offer per product, which is not always the cheapest seller; tl_product returns every
seller, color and price list.
| Tool | What it does |
|---|---|
tl_search | Search with prices, stock, rating; filters for price, brand, category; category/brand facets with their codes |
tl_find_cheapest | Cheapest in-stock products for a search, one flat list sorted by the real price |
tl_suggest | Product name → product codes (typeahead) |
tl_find_brand | Brand name → brand filter code and brand page |
| Tool | What it does |
|---|---|
tl_categories | Find category pages by name, list the top level, or a category's sub-pages |
tl_category_products | Products of a category, brand or promotion page, sorted and filtered |
tl_category_filters | A page's brands, categories, price range and attribute filters (RAM, screen, CPU, ...) with codes |
| Tool | What it does |
|---|---|
tl_product | Every offer: seller, color, warranty, stock, delivery, insurance, installment prices, specs |
tl_compare | 2-5 products side by side: price, stock, rating, every spec |
tl_reviews | Customer reviews, star distribution and the AI summary with pros and cons |
tl_price_basket | Exact total for seller items: discounts, insurance, quantity limits, cash vs installment |
| Tool | What it does |
|---|---|
tl_deals | Current discounts (biggest percent first) and timed home-page deals |
tl_campaigns | Current campaigns, or one campaign's sections and products |
tl_seller | A seller's rating, on-time and fault-free percentages, and its products |
| Tool | What it does |
|---|---|
tl_store_info | Physical stores, shipping methods and costs, 7-day returns, payment methods |
tl_faq | Search the help-center FAQ |
tl_shop_reviews | Customer reviews of the shop itself |
tl_find_location | Address or landmark → coordinates, province and city |
tl_reverse_geocode | Coordinates → address, province, city and neighbourhood |
All 19 tools are annotated readOnlyHint: true and return compact JSON, so they don't flood the agent's context.
AI agent (Claude, Cursor, Copilot, ...)
│
│ MCP over stdio
▼
technolife-mcp (runs on your machine)
│
│ HTTPS (GraphQL)
└──────▶ www.technolife.com
technolife-mcp runs locally and calls the same public GraphQL endpoints the technolife.com website uses.
There's no hosted server in between, no API key, and nothing about you is sent anywhere else.
Technolife sits behind Cloudflare, so requests go out through a Chrome-impersonating HTTP client. It sends at most 2
requests at a time with a little jitter, caches the category tree and home-page data for 5 minutes, and retries a
timeout, network error, 429 or 5xx up to twice. It only sends GraphQL query operations, never mutation.
final_price is after discount; discount_pct is computed from the two prices, because the site's own percent label is sometimes missing.null means not rated yet. Review and shop-review dates are Jalali, as the site shows them.tl_product shows all three and tl_price_basket totals any of them.tl_store_info(topic="shipping") has the rules.tl_product lists every seller.image URL (tl_product also an images list of up to 4). List cards give small thumbnails and tl_product larger gallery images; files are served as webp even though the URL ends in .png.آیفون 16, لپ تاپ لنوو). Category search treats Arabic ي/ك and half-space vs space as equal.TECHNOLIFE_MCP_PROXY.Yes: technolife-mcp is an unofficial MCP server with 19 read-only tools for search, seller and installment prices,
specs, reviews and deals. It calls the same public endpoints the technolife.com website uses; no API key is needed.
Add the server with claude mcp add technolife -- uvx technolife-mcp (or the matching config in
Quick start for Claude Desktop, Cursor, VS Code, Codex CLI, Gemini CLI and Windsurf), then ask in plain language, in Persian or English.
It is unofficial and not affiliated with Technolife. It is read-only (no login, basket or payment), runs on your machine, and is free under the MIT license.
Sort by price and accessories win. tl_search and tl_find_cheapest return the matching categories with their codes;
the agent passes the phone one back as category_code (e.g. 1 for mobile phones).
No, and that's deliberate. It has no login and never saves a basket or touches order or payment endpoints.
tl_price_basket only asks the server for prices. The agent finds the best offer; you buy on the site.
No. Technolife only prices shipping for a logged-in address, which this server never uses.
tl_store_info(topic="shipping") returns the shipping rules and methods.
No. It was tested from an Iranian home connection and from a Turkish IP, and both worked. Cloud servers outside Iran
were not tested; if Technolife blocks one, set TECHNOLIFE_MCP_PROXY.
Technolife sometimes resets connections; the server retries a failed connection, timeout, 429 or 5xx up to twice. If it keeps failing, check your connection or set
TECHNOLIFE_MCP_PROXY. Normal system proxy variables are ignored on purpose, because direct calls are the fastest.
technolife-mcp[browser]Technolife served a bot-check page. Install the optional extra (pip install "technolife-mcp[browser]") and run
patchright install chromium; a headless browser then clears the check once and the server reuses its cookies.
uvx is not foundUse the full path to uvx (where uvx on Windows, which uvx on macOS/Linux) as command.
npx @modelcontextprotocol/inspector uvx technolife-mcp
| Variable | Default | Meaning |
|---|---|---|
TECHNOLIFE_MCP_PROXY | unset | Optional HTTP proxy URL for every request, e.g. http://user:pass@host:port, or a comma-separated list used one at a time (the next one after a block). System proxy settings are ignored |
If Technolife serves a bot-check page, install technolife-mcp[browser] and run patchright install chromium; a headless browser then clears the check once and the server reuses its cookies.
technolife-mcp یک سرور MCP غیررسمی و فقطخواندنی برای تکنولایف، فروشگاه اینترنتی لوازم الکترونیکی در ایران، است. این سرور به دستیار هوش مصنوعی شما (Claude، Cursor، Copilot و ...) اجازه میدهد در تکنولایف جستجو کند، قیمت نقدی و اقساطی همه فروشندگان یک کالا را مقایسه کند، مشخصات فنی و نظرات را بخواند و تخفیفهای فعال را پیدا کند.
چه کارهایی میکند
نکتهها
TECHNOLIFE_MCP_PROXY را روی یک پراکسی HTTP بگذارید.نصب (اول uv را نصب کنید). در Claude Code:
claude mcp add technolife -- uvx technolife-mcp
در Claude Desktop، Cursor و بقیه برنامهها همان تنظیم بخش Quick start را بگذارید.
نمونه پرسشها
کلمات جستجو: تکنولایف، خرید اینترنتی موبایل، خرید لپتاپ، قیمت گوشی، قیمت لپتاپ، خرید اقساطی، مقایسه قیمت، تخفیف و کمپین تکنولایف، فروشگاه لوازم الکترونیکی، سرور MCP فارسی.
git clone https://github.com/sepehr071/technolife-mcp && cd technolife-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q # offline, against recorded responses
uv run python -m pytest -m live -q # real API
uv build
Tools live in src/technolife_mcp/search.py, catalog.py, product.py, offers.py and info.py; each is a typed
async function with a docstring that tells the agent when to use it. Issues and PRs are welcome, especially new tools
and fixes for API changes.
Releases: bump the version in pyproject.toml and server.json, then push a v* tag. GitHub Actions tests,
publishes to PyPI and the MCP Registry, and creates the GitHub Release.
Unofficial and not affiliated with or endorsed by Technolife. It is read-only and uses the public endpoints of the technolife.com website, which can change without notice. Prices and stock change all the time; check them on the site before you buy. Please keep request rates reasonable.
Built and maintained by Sepehr Radmard (سپهر رادمرد). Connect on LinkedIn or follow @sepehr071 on GitHub for more MCP servers for Iranian websites, all listed in iran-mcp. If this saves you time, a star on the repo helps other people find it.
If this saves you clicks, a star helps others find it.
FAQs
Unofficial read-only MCP server for Technolife: search electronics, compare sellers and installment prices, find deals.
We found that technolife-mcp demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Security News
Cloudflare introduces tsrs, a Rust port of TypeScript’s compiler promising faster checks and lower memory use, with the TypeScript team’s help.
Security News
The PHP Foundation says Chainguard broke a security embargo ahead of critical RCE patches, as leaks disrupted the coordinated release.
Security News
PHP releases emergency patches for two critical RCE vulnerabilities as agencies urge organizations to take unpatched sites offline.