📱 technolife-mcp
Let your AI agent shop around on Technolife.
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.
Quick start · What it can do · Tools · FAQ · فارسی
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 Code
claude mcp add technolife -- uvx technolife-mcp
Claude Desktop
Settings → Developer → Edit Config, then add:
{
"mcpServers": {
"technolife": { "command": "uvx", "args": ["technolife-mcp"] }
}
}
Cursor
Click Install in Cursor above, or add the Claude Desktop block to ~/.cursor/mcp.json.
VS Code (Copilot agent mode)
Click Install in VS Code above, or add to .vscode/mcp.json:
{
"servers": {
"technolife": { "type": "stdio", "command": "uvx", "args": ["technolife-mcp"] }
}
}
Anything else
It's a standard stdio MCP server: run uvx technolife-mcp, or pip install technolife-mcp and run 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
best offer per product; tl_product returns every seller, color and price list.
🔎 Search (4)
| 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 |
🗂️ Catalog (3)
| 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 |
📦 Product (4)
| 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 |
⚡ Deals and sellers (3)
| 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 |
ℹ️ Shop info (5)
| 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 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_priceis after discount;discount_pctis computed from the two prices, because the site's own percent label is sometimes missing. - Ratings are 0–5;
nullmeans 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_productshows all three andtl_price_baskettotals 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.
- Persian queries match best (
آیفون 16,لپ تاپ لنوو). Category search treats Arabic ي/ك and half-space vs space as equal.
FAQ
A phone search returns phone cases first
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).
Can it place an order for me?
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.
I get "did not answer in time" or "Could not reach"
Technolife sometimes resets connections; the server retries a failed connection once (timeouts are not retried). 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.
Claude Desktop says uvx is not found
Use the full path to uvx (where uvx on Windows, which uvx on macOS/Linux) as command.
How do I debug what the agent sees?
npx @modelcontextprotocol/inspector uvx technolife-mcp
Configuration
| Variable | Default | Meaning |
|---|---|---|
TECHNOLIFE_MCP_PROXY |
unset | HTTP proxy for every request, e.g. http://user:pass@host:port |
فارسی
technolife-mcp به دستیار هوش مصنوعی شما (Claude، Cursor، Copilot و ...) اجازه میدهد در تکنولایف جستجو کند، قیمت نقدی و اقساطی همه فروشندگان یک کالا را مقایسه کند، مشخصات فنی و نظرات را بخواند و تخفیفهای فعال را پیدا کند.
- فقط خواندنی است: وارد حساب نمیشود، سبد خرید ذخیره نمیکند و سفارش ثبت نمیکند.
- قیمت هر رنگ، فروشنده و گارانتی را همراه با قیمت اقساطی و هزینه بیمه نشان میدهد.
- همه قیمتها به تومان است.
- روی سیستم خود شما اجرا میشود و به هیچ سرور واسطی داده نمیفرستد.
نصب در Claude Code:
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.
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
Metadata
Release files for technolife-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| technolife_mcp-0.1.0.tar.gz | 117.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| technolife_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 149.1 kB
Release files / technolife_mcp-0.1.0.tar.gz
| Download URL | technolife_mcp-0.1.0.tar.gz |
|---|---|
| Size | 117.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4ba6b2f76e37d42287ea51e7bd520d7568dd12a1ac9f0c4348e37f2319901f0f
|
|
BLAKE2b-256 checksum How to use checksums |
a67bd8ef03ca43ed073a06f7bcfbfb4b9b6937c6e2d0b800b3f50b886116181f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency logRelease files / technolife_mcp-0.1.0-py3-none-any.whl
| Download URL | technolife_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 31.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2ffcdd03331904e188951e0c841a3fdcda313cbe6b79a35f3862243b7d4f40a3
|
|
BLAKE2b-256 checksum How to use checksums |
c48f0addcde8b9a7508c122f7614d1a7eedf3ca2024714490adc6a89cf658663
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.
Transparency log