# Shelfclub

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

- name: app.shelfclub/books
- version: 0.2.0
- connection class: R0 (autonomous)
- trust: 83/100 flags: no-repository
- quality: 86/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/app.shelfclub%2Fbooks
- tools: https://api.protogrid.dev/v1/servers/app.shelfclub%2Fbooks/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "books": {
      "type": "http",
      "url": "https://mcp.shelfclub.app/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% +updated-10d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 86/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 6 of 6 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 1,532 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 75 (weight 15)

- warn `stability.changes`: 12 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 6, about 1,532 tokens to load them all
- tool set hash: a4839fabe0e16d60ca38c205ff73b886
- tools last changed: 2026-10-13T14:05:57.813Z
- badge: [![protogrid quality](https://protogrid.dev/badge/app.shelfclub/books.svg)](https://protogrid.dev/servers/app.shelfclub/books)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-13 `get_author` changed (description, inputSchema, outputSchema)
  - before: 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).
  - after: 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).
- 2026-10-13 `get_trending_books` changed (description, outputSchema)
  - before: 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).
  - after: 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).
- 2026-10-13 `get_similar_books` changed (description, inputSchema, outputSchema)
  - before: List the books in the Shelfclub catalog whose mood, vibe, pace and genre tags overlap most with those of a given book. 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.
  - after: List the books in the ShelfClub catalog whose mood, vibe, pace and genre tags overlap most with those of a given book. 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.
- 2026-10-13 `get_book` changed (description, inputSchema, outputSchema)
  - before: 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.
  - after: 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.
- 2026-10-13 `find_books_by_mood` changed (description, outputSchema)
  - before: 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.
  - after: 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.
- 2026-10-13 `search_books` changed (description, outputSchema)
  - before: 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).
  - after: 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).
- 2026-10-12 `get_author` changed (description)
  - before: 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 machine-generated mood, vibe, pace and genre tags.
  - after: 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).
- 2026-10-12 `get_trending_books` changed (description)
  - before: 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 machine-generated mood, vibe and pace tags.
  - after: 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).
- 2026-10-12 `get_similar_books` changed (description)
  - before: List the books in the Shelfclub catalog whose mood, vibe, pace and genre tags overlap most with those of a given book. The tags are machine-generated, 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.
  - after: List the books in the Shelfclub catalog whose mood, vibe, pace and genre tags overlap most with those of a given book. 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.
- 2026-10-12 `get_book` changed (description, outputSchema)
  - before: 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 machine-generated mood, vibe, pace and genre tags. A lookup by id also returns the Shelfclub author id of each author that has an author record.
  - after: 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.

Full history: https://api.protogrid.dev/v1/servers/app.shelfclub%2Fbooks/changes

## Remotes

- https://mcp.shelfclub.app/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (6)

- `find_books_by_mood`: 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.
- `get_author`: 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).
- `get_book`: 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.
- `get_similar_books`: List the books in the ShelfClub catalog whose mood, vibe, pace and genre tags overlap most with those of a given book. 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.
- `get_trending_books`: 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).
- `search_books`: 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).