Shelfclub
Server Details
Search a catalog of 1.7 million books and find books by mood, vibe, pace or genre. Read-only.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- ShelfClub
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: mood-tag discovery, author lookup, single-book lookup, similar-book discovery, trending list, and title/author search. The boundaries are especially clear between search_books (title/author text search) and find_books_by_mood (tag-based discovery). No two tools appear likely to be confused.
All names use snake_case and generally follow a verb_noun pattern: get_author, get_book, get_similar_books, get_trending_books, search_books. The only notable deviation is find_books_by_mood, which uses 'find' and an extra preposition, but it remains readable and predictable.
Six tools is well-scoped for a read-only book catalog focused on discovery and lookup. Each tool covers a distinct reader need—search, mood browsing, author lookup, book details, similarity, and trends—without obvious redundancy.
The surface covers the core catalog workflows: discovery by mood/tags, title/author search, book and author details, similar books, and trending books. Minor gaps remain, such as no dedicated browse-by-series or browse-by-genre-only tool, but agents can work around these using existing search and tag tools.
Available Tools
6 toolsfind_books_by_moodFind books by moodARead-onlyIdempotentInspect
Find books in the ShelfClub catalog by mood, vibe, pace and genre tags. At least one tag is needed. Books that carry every requested tag are listed first, most read first; when there are fewer of those than asked for, books that carry some of the tags follow, and matchAll says how many of the books returned carry every tag. Each book is returned with its own tags. Returns up to 10 books, each with its ShelfClub id, authors, description, reader rating, series and shelfclub.app link. The tags are machine-generated, or voted for by at least three readers of the book.
Inputs: pace, limit, moods, vibes, +1 more. Returns: books, status, hasMore, matchAll, +2 more
get_authorGet authorARead-onlyIdempotentInspect
Look up an author in the ShelfClub catalog by ShelfClub author id, which get_book returns for the authors of a book. Returns the author's name, biography, birth and death dates and shelfclub.app link. With include_books, also returns up to 10 of their books, the most recently published first, each with its ShelfClub id, description, reader rating, series, shelfclub.app link, and mood, vibe, pace and genre tags (machine-generated, or voted for by at least three readers of the book).
Inputs: id (required), include_books. Returns: books, author, status, booksTotal, +2 more
get_bookGet book detailsARead-onlyIdempotentInspect
Look up one book in the ShelfClub catalog, by its ShelfClub id or by ISBN. Returns its description, authors, reader rating, series, an edition (ISBN, page count, publisher, publication date, language), its shelfclub.app link, and its mood, vibe, pace and genre tags (machine-generated, or voted for by at least three readers of the book). A lookup by id also returns the ShelfClub author id of each author that has an author record, and which of the moods, vibes and pace readers of the book voted for, with how many did. These tools do not return content warnings: if asked, say so, and do not infer them from the tags or present anything as ShelfClub's.
Inputs: id, isbn. Returns: book, status, tagProvenance, retryAfterSeconds
get_similar_booksGet similar booksARead-onlyIdempotentInspect
List the books in the ShelfClub catalog whose mood, vibe, pace and genre tags overlap most with those of a given book, chosen from its 10,000 most-read books. The tags are machine-generated, or voted for by at least three readers of the book, and a book that has none has no similar books. Returns up to 10 books, each with its ShelfClub id, authors, description, reader rating, series, tags and shelfclub.app link.
Inputs: id (required), limit. Returns: books, status, tagProvenance, retryAfterSeconds
get_trending_booksGet trending booksARead-onlyIdempotentInspect
List the books trending on ShelfClub: the books its readers have been shelving come first, then the catalog's most widely read books. Returns up to 10 books, each with its ShelfClub id, authors, description, reader rating, series, shelfclub.app link, and mood, vibe and pace tags (machine-generated, or voted for by at least three readers of the book).
Inputs: limit. Returns: books, status, tagProvenance, retryAfterSeconds
search_booksSearch booksARead-onlyIdempotentInspect
Search the ShelfClub book catalog by title or author name. Returns up to 10 books, each with its ShelfClub id, authors, description, reader rating, series, shelfclub.app link, and mood, vibe, pace and genre tags (machine-generated, or voted for by at least three readers of the book).
Inputs: query (required), limit. Returns: books, total, status, exactMatch, +2 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Read-only search and retrieval of published books, articles and authors, with public catalog links.
Book discovery using an AI-curated book catalog that eliminates hallucinations and surfaces lesser-known titles.
Read-only access to The Family Almanac's parenting-focused book library, grounded guide metadata...
Personalised book recommendations, filtered to what's on your public library's shelf right now.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables read-only search and retrieval of the public Reknihy.cz book catalog, including filtering, sorting, ISBN lookup, category browsing, and access to product details such as price, availability, and images.4ISC
- FlicenseNot gradedqualityCmaintenanceProvides a read-only API over a book catalogue, offering tools to search books, retrieve book details and series, and inspect provenance and source agreement data.-
- AlicenseAqualityBmaintenanceEnables compatible AI clients to turn natural-language novel preferences into search queries and retrieve public metadata such as titles, authors, summaries, keywords, ratings, and completion status.1MIT
- AlicenseBqualityBmaintenanceEnables AI agents to get book recommendations by topic or mood, discover serendipitous blind-date picks from first sentences, and access free public-domain classics with read-now availability, all with no API keys required.530 PyPIMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.