# 30book [Health: Active]

**Category:** 🛒 E-Commerce  
**Repository:** https://github.com/sepehr071/30book-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/30book

## Description
Unofficial read-only 30book: search Iranian printed books, compare editions and prices.

## Tools
Capabilities this server exposes over MCP:

- **sb_search** — Search by title (exact phrase or word by word) with sort, in-stock, publisher, author and translator filters; 20 per page
- **sb_browse** — Books of a category (section, subject, topic), fiction genre, national literature, literary award or tag
- **sb_publisher** — One publisher's catalogue with a short description
- **sb_author** — Everything by one author or translator
- **sb_find_publisher** — Publisher name to id
- **sb_find_person** — Author / translator name to id
- **sb_categories** — Category sections and their subjects (codes for `sb_browse`)
- **sb_collections** — Genres, national literatures, award lists and current tags
- **sb_book** — Price, final price, discount %, stock, authors, translators, publisher, pages, cover, size, ISBN, print run, year, categories, rating, description
- **sb_similar** — Similar books, more by the author, more by the translator
- **sb_reviews** — Reader comments with stars, plus the rating summary
- **sb_bestsellers** — Site-wide best sellers
- **sb_new_releases** — Newest books
- **sb_deals** — The discounted-books page, biggest discount first on request

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "30book": {
    "command": "uvx",
    "args": ["30book-mcp"],
    "env": {
      "SIBOOK_MCP_PROXY": ""
    }
  }
}
```

**Requires environment variables:** `SIBOOK_MCP_PROXY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What 30book does

The 30book MCP server connects an MCP client to 30book.com, an Iranian online bookstore listing printed books in Persian and other languages. It is intended for catalog research rather than transactions. Agents can search titles, inspect editions, compare publishers, check Toman prices and discounts, review availability, and examine bibliographic details.

The 30book MCP server is part of the E-Commerce category, but its access is strictly read-only. It does not log in, add items to a cart, place orders, manage wishlists, or submit reviews. It also does not cover e-books or audiobooks.

## How it works

The server retrieves and parses pages from 30book.com without using a public 30book API. Book, home, and landing pages are read from server-rendered HTML. Search and catalog pages use a Blazor Server session over SignalR long polling; the server processes the returned render data and extracts book cards without simulating browser clicks.

Search and listing requests support paging, sorting, and filters. A typical investigation starts with a title search, continues to a detailed book lookup, and then branches to similar books or reader reviews. For an author or publisher, resolve the name to an identifier first, then pass that identifier to the relevant catalog tool.

Responses are compact JSON. Prices are reported in Toman, with separate list and final-price fields plus a discount percentage. Stock is represented as yes or no, not as an inventory count. List requests generally take two to five seconds, while individual book pages usually take about one second.

## Setup and configuration

Install Python 3.10 or newer and `uv`, then run the server with:

```bash
uvx 30book-mcp
```

Claude Code can register it with:

```bash
claude mcp add 30book -- uvx 30book-mcp
```

The server uses stdio transport. Claude Desktop, Cursor, and VS Code can run `uvx` with `30book-mcp` as its argument. Installing the package with `pip install 30book-mcp` is another supported option.

No login, account, or API key is required. If 30book.com cannot be reached from the host network, set `SIBOOK_MCP_PROXY` to an HTTP proxy URL. The server intentionally does not use general system proxy variables for site requests.

## Tools and capabilities

The 14 tools use the `sb_` prefix. Search and discovery tools include:

- `sb_search` for title searches, sorting, stock, publisher, author, and translator filters, with 20 results per page.
- `sb_browse` for subjects, sections, topics, fiction genres, national literatures, awards, and tags.
- `sb_publisher` and `sb_author` for publisher and person catalogs.
- `sb_find_publisher`, `sb_find_person`, `sb_categories`, and `sb_collections` for resolving identifiers and browsing available classifications.

Book-level tools include `sb_book`, `sb_similar`, and `sb_reviews`. A book record can include prices, discount, stock, authors, translators, publisher, page count, cover type, dimensions, ISBN, print run, publication year, categories, rating, and description. Popularity and pricing tools include `sb_bestsellers`, `sb_new_releases`, and `sb_deals`.

## Limitations and notes

The 30book MCP server works best with Persian search terms for titles and names. Some names may use Arabic character variants, so a shorter query or the extended search option may help when results are empty. Keep request rates low because the project is unofficial and is not affiliated with 30book.

Use the tool identifiers returned by lookup operations when calling author, publisher, browse, or book tools. The service provides availability as a boolean-style value rather than a stock quantity, and site reachability may depend on the network where the MCP process runs.

_Full upstream README: https://allmcps.com/mcp/30book/readme_