# Taaghche (pypi · taaghche-mcp)

Unofficial read-only Taaghche: search Persian ebooks and audiobooks, compare prices, read reviews.

- Trust score: 64/100 (medium)
- Change this week: −15
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-22

## Components

- pypi · `taaghche-mcp`: 64/100 (this document), [markdown](https://verifymcp.io/servers/sepehr071-taaghche-mcp/taaghche-mcp.md), [page](https://verifymcp.io/servers/sepehr071-taaghche-mcp/taaghche-mcp)

## Channel facts

- Registry: `pypi`
- Package: `taaghche-mcp`
- Version: `0.3.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-22.

- **Supply Chain Security**: 50/100
  - Malware scan not yet available for this package.
  - No known CVEs affecting this package version or its production dependencies.
  - Runs hatchling.build at install time, a recognised build step with no custom scripting around it.
  - 1 of 35 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to sepehr071/taaghche-mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 0 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 64/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 1836 tokens (~153/item across 12 items; 12 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability check failed: the tool surface changed between 0.1.2 and 0.3.1: 0 tool removals, 12 breaking changes, 0 additions.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 12 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 13 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the Taaghche MCP server?

Taaghche runs locally as a PyPI package, launched with uvx taaghche-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add sepehr071-taaghche-mcp -- uvx taaghche-mcp
```

### Cursor

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

### VS Code

```json
{
  "servers": {
    "sepehr071-taaghche-mcp": {
      "command": "uvx",
      "args": [
        "taaghche-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add sepehr071-taaghche-mcp -- uvx taaghche-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sepehr071-taaghche-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "taaghche-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add sepehr071-taaghche-mcp --command uvx --arg taaghche-mcp
```

### Hermes

```yaml
mcp_servers:
  sepehr071-taaghche-mcp:
    command: "uvx"
    args: ["taaghche-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "sepehr071-taaghche-mcp": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "taaghche-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add sepehr071-taaghche-mcp -t stdio -c uvx -a taaghche-mcp
```

### Other

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

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-22 (score 64, 0)

- [functional] Package version: 0.1.2 → 0.3.1

### 2026-10-21 (score 64, −15)

- [security regression] Malware scan: pass → unverified

### 2026-10-19 (score 79, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-10-18 (score 64, −15)

- [security regression] Malware scan: pass → unverified
- [functional] Package version: 0.1.2 → 0.3.0
- [functional] Package version: 0.1.2 → 0.2.0

### 2026-10-16 (score 79, 0)

- [security regression] Stability: unverified → fail
- [security regression] Tool safety: pass → unverified
- [security regression] Malware scan: pass → unverified
- [security] Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional improvement] Schema quality: 214 → 148
- [functional] Schema quality: excellent → good
- [functional] Package version: 0.1.2 → 0.2.0

### 2026-10-14 (score 79, +45)

- [security improvement] Injection markers: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [security] First check of Judged manipulation: pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] MCP protocol: unverified → pass
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: excellent
- [functional] First check of Destructive annotations: pass
- [functional] First check of Schema quality: fail
- [functional] First check of Tool coverage: 100
- [functional] First check of Tool coverage: 100

### 2026-10-13 (score 34, −15)

- [security regression] Malware scan: pass → unverified
- [functional] Package version: 0.1.1 → 0.1.2

### 2026-10-12 (score 49)

First indexed and scored.

## MCP tools (12)

### `tg_search` (~194 tokens)

Search books

Search ebooks and audiobooks by title, author or topic: price, discount, rating, format.

Price limits and free_only apply to the scanned results, so a narrow range may need next_cursor.
Next: tg_book for details, tg_browse for a category.

Input parameters:

- `cursor`: next_cursor of the previous reply.
- `discounted_only` (boolean): Only discounted books.
- `format` (string): ebook, audiobook or any.
- `free_only` (boolean): Only free books.
- `max_price`: Maximum price in Toman, e.g. 100000.
- `min_price`: Minimum price in Toman, e.g. 20000.
- `query` (string, required): Title, author or topic, Persian works best, e.g. 'شازده کوچولو'.
- `sort` (string): cheapest = ascending price.
- `subscription_only` (boolean): Only Binahayat subscription books.

### `tg_suggest` (~54 tokens)

Search suggestions

Search-box typeahead: up to about 10 matching book titles with id and publisher. For prices use tg_search.

Input parameters:

- `term` (string, required): Start of a title or author, e.g. 'شازده'.

### `tg_book` (~93 tokens)

Book details

One book: price, discount, format, pages or duration, people, rating breakdown, categories, ISBN.

Next: tg_reviews, tg_similar, tg_author (author_slugs), tg_publisher (publisher_slug).

Input parameters:

- `book_id` (integer, required): Book id (from tg_search), e.g. 6426 or 72107.
- `description_chars` (integer): Cut the description after this many characters.

### `tg_reviews` (~103 tokens)

Book reviews

Reader reviews, most liked first: rating, text, likes, reply count. Page with offset.

Input parameters:

- `book_id` (integer, required): Book id (from tg_search), e.g. 6426 or 72107.
- `limit` (integer): Reviews per call.
- `max_chars` (integer): Cut each review after this many characters.
- `offset` (integer): How many reviews to skip.
- `reply_to`: Review id: return its replies instead.

### `tg_similar` (~55 tokens)

Similar books

Related books as separate lists (similar works, same author, same publisher): price, format, rating.

Input parameters:

- `book_id` (integer, required): Book id (from tg_search), e.g. 6426 or 72107.

### `tg_browse` (~179 tokens)

Browse a category

List books of a category (or the whole catalog), 16 per page, by sort, format and price ceiling.

max_price is applied here over up to 5 pages (`scanned`); exact with sort='cheapest'. For words use tg_search.

Input parameters:

- `category`: Category id (e.g. 68) or slug (e.g. 'کتاب-داستان-خارجی') from tg_categories; empty = all.
- `cursor`: next_cursor of the previous reply.
- `discounted_only` (boolean): Only discounted books.
- `format` (string): ebook, audiobook or any.
- `free_only` (boolean): Only free books.
- `max_price`: Maximum price in Toman, e.g. 100000.
- `sort` (string): hot = trending ranking; cheapest = ascending price.

### `tg_bestsellers` (~115 tokens)

Bestsellers

Hottest books now (Taaghche's trending ranking; no sales numbers are public), overall or per category.

For best-selling order of a keyword use tg_search(sort='bestselling'). Next: tg_book.

Input parameters:

- `category`: Category id (e.g. 68) or slug (e.g. 'کتاب-داستان-خارجی') from tg_categories; empty = all.
- `cursor`: next_cursor of the previous reply.
- `format` (string): ebook, audiobook or any.

### `tg_new_releases` (~90 tokens)

New releases

Newest books (most recently added first), overall or per category. Next: tg_book.

Input parameters:

- `category`: Category id (e.g. 68) or slug (e.g. 'کتاب-داستان-خارجی') from tg_categories; empty = all.
- `cursor`: next_cursor of the previous reply.
- `format` (string): ebook, audiobook or any.

### `tg_free_books` (~107 tokens)

Free books

Free books and audiobooks (price 0), most downloaded first by default. Next: tg_book.

Input parameters:

- `category`: Category id (e.g. 68) or slug (e.g. 'کتاب-داستان-خارجی') from tg_categories; empty = all.
- `cursor`: next_cursor of the previous reply.
- `format` (string): ebook, audiobook or any.
- `sort` (string): hot = trending ranking; cheapest = ascending price.

### `tg_categories` (~104 tokens)

Categories

Category tree: top-level groups (id) and standalone categories, each with a slug.

Pass an id or slug to tg_browse and the other list tools. Ebook and audiobook slugs differ (audio ends in
«-صوتی»). Sub-categories need group=<id> (and format).

Input parameters:

- `format` (string): ebook, audiobook or any.
- `group`: Top-level group id from a previous call: only it, with sub-categories.

### `tg_author` (~148 tokens)

Author and books

An author's profile (with a slug: nationality, life dates, bio) and their books, 16 per page.

Sort, format and max_price work like tg_browse. Next: tg_book.

Input parameters:

- `author` (required): Author slug (e.g. 'آنتوان-دوسنت-اگزوپری', from tg_book author_slugs) or id (e.g. 2072).
- `cursor`: next_cursor of the previous reply.
- `format` (string): ebook, audiobook or any.
- `max_price`: Maximum price in Toman, e.g. 100000.
- `sort` (string): hot = trending ranking; cheapest = ascending price.

### `tg_publisher` (~131 tokens)

Publisher and books

A publisher's description and its books, 16 per page.

Sort, format and max_price work like tg_browse. Next: tg_book.

Input parameters:

- `cursor`: next_cursor of the previous reply.
- `format` (string): ebook, audiobook or any.
- `max_price`: Maximum price in Toman, e.g. 100000.
- `publisher` (required): Publisher slug (e.g. 'کتاب-کوله-پشتی', from tg_book publisher_slug) or id (e.g. 113).
- `sort` (string): hot = trending ranking; cheapest = ascending price.

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Dependencies. The full working is on the page: https://verifymcp.io/servers/sepehr071-taaghche-mcp/taaghche-mcp#diagnostics

## Score history

- 2026-10-22: 64
- 2026-10-21: 64
- 2026-10-20: 79
- 2026-10-19: 79
- 2026-10-18: 64
- 2026-10-17: 79
- 2026-10-16: 79
- 2026-10-15: 79
- 2026-10-14: 79
- 2026-10-13: 34
- 2026-10-12: 49

## Common questions

### What is the Taaghche MCP server?

Taaghche is an MCP server listed in the public MCP registry as io.github.sepehr071/taaghche-mcp. Unofficial read-only Taaghche: search Persian ebooks and audiobooks, compare prices, read reviews. This page covers its PyPI package (taaghche-mcp).

### Is the Taaghche MCP server safe to use?

Taaghche scores 64 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 22 October 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Taaghche MCP server expose?

Taaghche exposes 12 tools: tg_search, tg_suggest, tg_book, tg_reviews, tg_similar, and 7 more. Their descriptions and schemas cost roughly 1,373 tokens of context every time the server is loaded.

### Is the Taaghche MCP server still maintained?

Taaghche is still listed as active in the MCP registry. We last reached this channel on 22 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Taaghche MCP server under?

Taaghche declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- PyPI project: https://pypi.org/project/taaghche-mcp/
- Socket report: https://socket.dev/pypi/package/taaghche-mcp
- Repository: https://github.com/sepehr071/taaghche-mcp
- Changelog RSS feed: https://verifymcp.io/servers/sepehr071-taaghche-mcp/taaghche-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/sepehr071-taaghche-mcp/taaghche-mcp.json
- HTML version of this page: https://verifymcp.io/servers/sepehr071-taaghche-mcp/taaghche-mcp