Shelfclub

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Search a catalog of 1.7 million books and find books by mood, vibe, pace or genre. Read-only.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Shelfclub": {
      "url": "https://mcp.shelfclub.app/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (6)

• search_books read-only

  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).

  Parameters:

  • query (required) — string — A book title, an author name, or both.
  • limit — integer — How many books to return.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• find_books_by_mood read-only

  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.

  Parameters:

  • pace — string — How quickly the story moves.
  • limit — integer — How many books to return.
  • moods — array — How the book feels to read.
  • vibes — array — The kind of reading experience.
  • genres — array

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_book read-only

  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.

  Parameters:

  • id — string — The ShelfClub id of the book, as the other tools return it. Give this or `isbn`, not both.
  • isbn — string — An ISBN-10 or ISBN-13, with or without hyphens.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_similar_books read-only

  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.

  Parameters:

  • id (required) — string — The ShelfClub id of the book, as the other tools return it.
  • limit — integer — How many books to return.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_trending_books read-only

  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).

  Parameters:

  • limit — integer — How many books to return.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_author read-only

  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).

  Parameters:

  • id (required) — string — The ShelfClub id of the author, from the `authorLinks` of a get_book result.
  • include_books — boolean — Also return up to 10 of the author's books.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.