30book

30book-mcp: 30book MCP server for AI agents

Let your AI agent search Iran's 30book bookstore (۳۰بوک).
An unofficial, read-only MCP server for 30book, an Iranian online bookstore with about 200,000 printed books: search by title, compare editions and publishers, see list and discounted prices in Toman, stock, ISBN, authors, translators, reviews, best sellers and discounts, all from Claude, Cursor or Copilot.

PyPI Python CI MCP Registry License: MIT Install in VS Code

For AI agents · Why · What it can do · Quick start · Tools · How it works · Good to know · FAQ · Configuration · فارسی · Development · Related servers · Disclaimer · License

For AI agents

• What: unofficial MCP server for 30book (30book.com), an Iranian online bookstore. Search terms work best in Persian (titles, names); prices in Toman.
• Install: uvx 30book-mcp or claude mcp add 30book -- uvx 30book-mcp. Transport: stdio. Needs uv (Python 3.10+), or pip install 30book-mcp.
• Auth: none, no API key or account. Optional SIBOOK_MCP_PROXY (HTTP proxy URL, or a comma-separated list, for requests to 30book.com).
• Access: read-only. It never logs in and has no cart, checkout, wishlist or review-writing tools, so no confirmation is needed before calling any tool.
• Tools: 14, all prefixed sb_. Start with sb_search, sb_book, sb_bestsellers, sb_deals, sb_browse. Typical sequence: sb_search -> sb_book -> sb_similar or sb_reviews; for one person or publisher, sb_find_person / sb_find_publisher -> sb_author / sb_publisher.
• Units: prices in Toman (price list price, final_price to pay, discount_pct int). Stock is yes/no, never a count. About 20 books per page (award pages about 22).
• Use when: comparing editions, publishers, prices, stock or ratings of printed Iranian and foreign books on 30book.
• Do not use when: the user wants to buy or order (no cart or checkout), needs shipping cost (quoted at checkout), wants e-books or audiobooks, or other bookstores.
• Machine-readable: server.json and the iran-mcp catalog (TOOLS.md, servers.json, llms.txt).

Why

30book has no public API and its list pages are drawn by a live Blazor Server session, so a plain scraper sees empty pages. This server speaks that protocol (SignalR long polling, no browser needed) and parses the book pages, so an agent can answer "cheapest edition of Little Prince with a hard cover", "everything by this translator under 300,000 Toman" or "what are the best sellers in history" in a few calls.

What it can do

• Search books by title (exact phrase or word by word), with sort, in-stock, publisher, author and translator filters
• Compare editions and publishers: the same title from several publishers, list price against the price to pay
• Book details: price, discount, stock, authors, translators, publisher, pages, cover, size, ISBN, language, edition (print number), year (Shamsi), weight, categories, rating, tags, description
• Browse categories, fiction genres, national literatures, literary award lists and tags
• Publishers and people: one publisher's catalogue, everything by an author or translator, name to id lookups
• Reader opinion: reviews with stars and the rating summary, similar books
• Popular and cheap: site-wide best sellers, newest books, best sellers by biggest discount
• Read-only by design: no login, no cart, no orders

Example prompts:

• "Cheapest edition of The Little Prince (شازده کوچولو) with a hard cover on 30book?"
• "List books by this translator under 300,000 Toman and show their ratings."
• "What are the best sellers in history right now, and which has the biggest discount?"
• ارزان‌ترین چاپ رمان «صد سال تنهایی» در ۳۰بوک کدام است؟
• پرفروش‌ترین کتاب‌های روانشناسی را با قیمت و تخفیف نشان بده.
• کتاب‌های این ناشر را از ارزان به گران مرتب کن.

Quick start

You need uv. No API key or account.

claude mcp add 30book -- uvx 30book-mcp

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

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

codex mcp add 30book -- uvx 30book-mcp

[mcp_servers.30book]
command = "uvx"
args = ["30book-mcp"]

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

Behind a proxy, set SIBOOK_MCP_PROXY=http://host:port (system proxy variables are ignored on purpose).

Tools

All 14 tools are read-only and prefixed sb_. Prices are Toman. Pass book, publisher and person ids between tools.

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

How it works

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  30book-mcp  (runs on your machine)
      │
      │  HTTPS (Chrome TLS/HTTP2 fingerprint) + SignalR long polling
      └──────▶  30book.com   book pages, Blazor-drawn list pages

• Book pages, the home page and landing pages are plain server-rendered HTML and are parsed directly.
• Search, category, publisher, author, genre and tag pages are built after load by a Blazor Server circuit. The server opens one over SignalR long polling, applies the binary render batches to a small DOM and reads the cards. Paging, sort and filters are URL query parameters, so no clicks are simulated; only the name boxes on the publisher and author index pages use a fired event.
• It runs on your machine and calls 30book directly; there is no hosted server in between.

Good to know

• Prices are in Toman. HTML prices are Toman; the JSON-LD on book pages is Rial (x10) and is only used for sold-out books.
• price is the list price, final_price is what you pay, discount_pct is computed. in_stock: false means sold out (the price may be the last known one).
• Stock is yes/no only, never a count.
• Speed: list pages take 2 to 5 seconds (a Blazor session is opened per list), book pages about 1 second. Book pages are cached for 5 minutes, so book -> similar -> reviews is one fetch.
• Search is name-fragment based. The site stores some names with Arabic yeh / kaf, so a person or publisher lookup can miss; try a shorter word.
• Categories: bts-N section pages are landing pages only; lists work for subject and topic codes (see sb_categories). Award pages show about 22 books per page and ignore sort.
• No price-range filter and no result count; only the last page number is known.
• Special offers on the site are mostly stationery, so sb_deals uses best sellers or one subject sorted by discount.
• Not covered: shipping cost (quoted at checkout after login), e-books, audiobooks, buying.
• Request rate: at most 2 requests at once with a short random delay, and timeouts, 429 and 5xx are retried up to twice. Keep your own call rate low; the site's robots.txt disallows */search for crawlers.
• Proxy: SIBOOK_MCP_PROXY (see Configuration).

FAQ

npx @modelcontextprotocol/inspector uvx 30book-mcp

Configuration

فارسی: سرور MCP کتاب ۳۰بوک

claude mcp add 30book -- uvx 30book-mcp

Development

git clone https://github.com/sepehr071/30book-mcp && cd 30book-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q            # offline, recorded pages
uv run python -m pytest -m live -q    # real site, one test per tool

Tools live in src/sibook_mcp/catalog.py and product.py (the Python package is sibook_mcp, because a module name cannot start with a digit); each is a typed async function with a docstring that tells the agent when to use it. A test checks that the tool tables in this README match the server. Issues and PRs are welcome.

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

• Taaghche MCP server for Iranian e-books and audiobooks
• Fidibo MCP server for Persian e-books and audiobooks
• Shopino MCP server for another Iranian online shop
• Digikala MCP server for Iran's largest online store
• iran-mcp: catalog of all Iranian-service MCP servers

Disclaimer

Unofficial and not affiliated with or endorsed by 30book. It reads the site's public pages, which can change without notice. It is read-only: it never logs in and never changes anything on the site. Please keep request rates reasonable.

Author

Built and maintained by Sepehr Radmard (سپهر رادمرد). Connect on LinkedIn or follow @sepehr071 on GitHub for more MCP servers for Iranian websites, all listed in iran-mcp. If this saves you time, a star on the repo helps other people find it.

License

MIT

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