technolife-mcp: Technolife MCP server for AI agents

Let your AI agent shop around on Technolife (تکنولایف).
An unofficial, read-only MCP server for the Iranian electronics store: 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 · Quick start · What it can do · Tools · FAQ · فارسی

For AI agents

• What: unofficial MCP server for Technolife (technolife.com, Iran), an electronics retailer. Queries in Persian match best; prices in Toman.
• Install: uvx technolife-mcp or claude mcp add technolife -- uvx technolife-mcp. Transport: stdio. Needs uv (Python 3.10+).
• Auth: none, no API key or account. Optional TECHNOLIFE_MCP_PROXY (HTTP proxy for every request).
• Access: read-only. No login, basket saving, orders or payment, so no confirmation is needed before calling any tool.
• Tools: 19, all prefixed tl_. Start with tl_find_cheapest, tl_search, tl_suggest, tl_deals. Typical sequence: tl_suggest -> tl_product -> tl_price_basket.
• Use when: comparing sellers, cash and installment prices, specs or reviews of electronics on Technolife.
• Do not use when: the user wants to place an order, or needs shipping cost (not available without a logged-in address).
• Output: compact JSON. Prices in Toman (final_price after discount), ratings 0-5, dates Jalali. Product codes like TLP-60492 and seller codes like TLS-15172 pass between tools.
• Machine-readable: server.json and the awesome-iran-mcp catalog (TOOLS.md, servers.json, llms.txt).

Why

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.}

What it can do

• 🔎 Search the whole catalog with prices, stock, rating, price range and brand/category filters
• 💸 Find the cheapest in-stock offers, re-sorted on the real price after discount
• 🏷️ Compare sellers of one product: price per color, warranty, stock, delivery time, seller reputation
• 💳 See installment prices (installment and buy now pay later) next to cash, and price a basket with insurance
• 📋 Read specs and compare up to 5 products side by side
• ⭐ Check quality with customer reviews, star distribution and the site's AI review summary
• ⚡ Catch deals: the main discount list, timed deals (تکنو تایم) and current campaigns
• 🔒 Read-only by design: no login, no basket, no orders, no payment

Quick start

You need uv.

claude mcp add technolife -- uvx technolife-mcp

{
  "mcpServers": {
    "technolife": { "command": "uvx", "args": ["technolife-mcp"] }
  }
}

{
  "servers": {
    "technolife": { "type": "stdio", "command": "uvx", "args": ["technolife-mcp"] }
  }
}

Then just ask:

• "Cheapest in-stock Lenovo laptop with 16 GB RAM on Technolife?"
• "Compare the iPhone 16 and iPhone 17: price, camera, battery."
• "Which deals on Technolife have more than 50% off right now?"
• ارزان‌ترین گوشی سامسونگ با قیمت اقساطی در تکنولایف؟

How it works

  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 endpoints the technolife.com website uses. There's no hosted server in between, no API key, and nothing about you is sent anywhere else.

Tools

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.

All 19 tools are annotated readOnlyHint: true and return compact structured JSON, so they don't flood the agent's context.

Good to know

• Prices are in Toman, as on the site (1 Toman = 10 Rial). final_price is after discount; discount_pct is computed from the two prices, because the site's own percent label is sometimes missing.
• Ratings are 0–5; null means not rated yet. Review and shop-review dates are Jalali, as the site shows them.
• Installments: the same seller item costs a few percent more in the installment and buy-now-pay-later price lists; tl_product shows all three and tl_price_basket totals any of them.
• Shipping cost is not included anywhere: Technolife only prices shipping for a logged-in address. tl_store_info(topic="shipping") has the rules.
• Price sorting: the site's price order is approximate (timed deals lag), so price sorts are re-sorted on the real price.
• Images: product results carry an absolute 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.
• Persian queries match best (آیفون 16, لپ تاپ لنوو). Category search treats Arabic ي/ك and half-space vs space as equal.

FAQ

npx @modelcontextprotocol/inspector uvx technolife-mcp

Configuration

فارسی: سرور MCP تکنولایف

claude mcp add technolife -- uvx technolife-mcp

Development

git clone https://github.com/sepehr071/technolife-mcp && cd technolife-mcp
uv sync
uv run pytest            # offline, against recorded responses
uv run pytest -m live    # real API
uv run ruff check .

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.

Related servers

• Digikala MCP server for Iran's largest online store
• MasterKala MCP server for gadgets and phone accessories
• awesome-iran-mcp: catalog of all Iranian-service MCP servers

Disclaimer

Unofficial and not affiliated with or endorsed by Technolife. It uses the public endpoints of the technolife.com website, which can change without notice. Please keep request rates reasonable.

License

MIT

If this saves you clicks, a star helps others find it.