taaghche-mcp: Taaghche MCP server for AI agents

Unofficial, read-only MCP server that lets your AI agent search Taaghche (طاقچه), the Iranian ebook and audiobook store: compare prices and formats, read reviews, browse bestsellers, new and free books.

Covers about 220,000 Persian and translated ebooks and audiobooks on taaghche.com, prices in Toman. No API key, no account. Works with Claude, Cursor and Copilot.

Quick start · Tools · FAQ · فارسی

For AI agents

• What: Unofficial MCP server for Taaghche (طاقچه, taaghche.com), an Iranian ebook and audiobook store. Queries in Persian work best; prices in Toman.
• Install: claude mcp add taaghche -- uvx taaghche-mcp (stdio, needs uv and Python 3.10+).
• Auth: none. Optional TAAGHCHE_MCP_PROXY sets an HTTP proxy (or a comma-separated list) for every request.
• Access: read-only. It cannot log in, buy, review or touch a library.
• Tools: 12, all prefixed tg_. Start with tg_search, tg_book, tg_reviews, tg_bestsellers, tg_free_books.
• Typical sequence: tg_search -> tg_book -> tg_reviews or tg_similar.
• Use when: the user wants to find an Iranian ebook or audiobook, compare price and format, read reader reviews, or list bestsellers, new releases and free books.
• Do not use when: the user wants to buy, borrow or read a book, or needs the user's own library or orders.
• Output: compact JSON. Prices in Toman (final_price is what you pay), rating 0-5, numeric book ids to pass between tools, paging with next_cursor.
• Machine-readable: server.json, and the catalog of all Iranian MCP servers awesome-iran-mcp (TOOLS.md, servers.json, llms.txt).

Quick start

You need uv.

claude mcp add taaghche -- uvx taaghche-mcp

Any other MCP client (Claude Desktop, Cursor, VS Code): run uvx taaghche-mcp as a stdio server (or pip install taaghche-mcp and run taaghche-mcp), e.g.

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

Then ask, for example:

• "Is there an audiobook of شازده کوچولو, and which edition is the cheapest?"
• "Free audiobooks about history, most downloaded first."
• "What do readers say about book 6426? Show the most liked reviews."
• پرفروش‌ترین کتاب‌های روان‌شناسی زیر ۱۰۰ هزار تومان کدامند؟

How it works

taaghche-mcp runs locally and calls the same public JSON endpoints the taaghche.com website uses (get.taaghche.com for books, reviews, lists and search, explore.taaghche.com for suggestions; the category menu is read from the home page). No hosted server in between. API map and quirks: ../taaghche/.

Tools

All 12 tools are annotated readOnlyHint: true and return compact structured JSON.

Find and read a book

Browse

Good to know

• Prices are in Toman. The API returns Toman (book 6426 is 58500 in the API and ۵۸,۵۰۰ تومان on the page). final_price is what you pay, price is before discount, discount_pct a whole percent, free is true for 0.
• The site cannot filter by price, so the price range is applied here. tg_search applies min_price, max_price and free_only to the results it scans (up to 5 pages of 12); the browse tools, tg_author and tg_publisher do the same with max_price (up to 5 pages of 16). scanned tells how many books were looked at; with sort="cheapest" the ceiling is exact and the scan stops early. Only free and discounted lists are filtered by the site.
• Paging: tg_search returns 12 books per page, the browse tools and tg_author / tg_publisher 16. Pass next_cursor back as cursor with the same other arguments.
• «Bestsellers» is the site's «hot» ranking. Taaghche publishes no sales numbers; for the true best-selling order of a keyword use tg_search(sort="bestselling").
• Binahayat (بی‌نهایت) subscription: in_subscription marks books included in it; the price is for buying the book permanently.
• Dates ending _fa are Persian (Jalali).
• Persian queries match best.

Configuration

FAQ

Is there a Taaghche API or MCP server for AI agents? Yes: this unofficial MCP server wraps the public JSON endpoints the taaghche.com website itself uses, so Claude, Cursor or Copilot can search books and read prices and reviews.

Is it official, safe and free? It is unofficial, open source (MIT) and free. It is read-only, needs no account or API key, and runs on your machine with no hosted server in between.

Can it buy or read a book for me? No. It only reads public catalog data: search, prices, reviews and lists. Buying and reading happen on taaghche.com or in the Taaghche app.

فارسی: سرور MCP طاقچه

Related servers

• Fidibo MCP server for Persian ebooks and audiobooks on Fidibo
• 30book MCP server for printed Iranian and foreign books
• All Iranian MCP servers: awesome-iran-mcp

Development

export HTTPS_PROXY=http://127.0.0.1:10898 HTTP_PROXY=http://127.0.0.1:10898   # uv downloads only
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q            # offline, on recorded fixtures
uv run python -m pytest -m live -q    # real API

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

License

MIT