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.

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 Code

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

Claude Desktop

Settings → Developer → Edit Config, then add:

{

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

</details>

Cursor

Add the Claude Desktop block above to ~/.cursor/mcp.json (or .cursor/mcp.json in a project).

VS Code (Copilot agent mode)

Click Install in VS Code above, or add to .vscode/mcp.json:

{

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

</details>

Codex CLI

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

Or in ~/.codex/config.toml:

[mcp_servers.30book]

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

</details>

Gemini CLI

Add to ~/.gemini/settings.json:

{

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

</details>

Windsurf

Add the Claude Desktop block to ~/.codeium/windsurf/mcp_config.json.

Anything else

It is a standard stdio MCP server: run uvx 30book-mcp, or pip install 30book-mcp and run 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.

Find books (8)

One book (3)

Popular and cheap (3)

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

Is there a 30book API or MCP server for AI agents?

30book has no public API. 30book-mcp is an unofficial MCP server with 14 read-only tools that reads the site's pages and exposes them to any MCP client, so an agent can search books and compare prices.

How do I use 30book with Claude, Cursor or Copilot?

Run claude mcp add 30book -- uvx 30book-mcp, or use the matching config in Quick start for Claude Desktop, Cursor, VS Code, Codex CLI, Gemini CLI or Windsurf, then ask in plain language, in Persian or English.

Can it buy a book for me?

No, and that is deliberate. It never logs in and never calls cart, checkout, wishlist or review endpoints. The agent finds the best edition; you order on the