Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

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

claude mcp add --transport http books https://mcp.shelfclub.app/mcp

[mcp_servers.books]
url = "https://mcp.shelfclub.app/mcp"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "books": {
      "type": "remote",
      "url": "https://mcp.shelfclub.app/mcp",
      "enabled": true
    }
  }
}

{
  "mcpServers": {
    "books": {
      "type": "http",
      "url": "https://mcp.shelfclub.app/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=books&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLnNoZWxmY2x1Yi5hcHAvbWNwIn0%3D"
}

{
  "servers": {
    "books": {
      "type": "http",
      "url": "https://mcp.shelfclub.app/mcp"
    }
  }
}

{
  "mcpServers": {
    "books": {
      "httpUrl": "https://mcp.shelfclub.app/mcp"
    }
  }
}

extensions:
  "books":
    enabled: true
    name: "books"
    type: streamable_http
    uri: "https://mcp.shelfclub.app/mcp"
    timeout: 300

Quality 86 / 100good

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene100 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations6 of 6 tools declare readOnlyHint or destructiveHint
pass
tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
pass
tools.token_costabout 1,532 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability75 · weight 15

warn
stability.changes12 tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

6 tools, about 1,532 tokens to load them all · tool set a4839fabe0e1 · tools last changed 2026-10-13 · checked 2026-10-19 10:52 UTC

Tool changes

2026-10-13get_authorchangeddescription, input schema, output schema
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 · 100% of words in common
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-13get_trending_bookschangeddescription, output schema
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 · 100% of words in common
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-13get_similar_bookschangeddescription, input schema, output schema
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 · 100% of words in common
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-13get_bookchangeddescription, input schema, output schema
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 · 100% of words in common
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-13find_books_by_moodchangeddescription, output schema
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 · 100% of words in common
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-13search_bookschangeddescription, output schema
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 · 100% of words in common
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-12get_authorchangeddescription
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 · 90% of words in common
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-12get_trending_bookschangeddescription
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 · 82% of words in common
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-12get_similar_bookschangeddescription
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 · 84% of words in common
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-12get_bookchangeddescription, output schema
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 · 78% of words in common
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.

Showing the latest 10. Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 83 / 100

no-repository

provenance55

liveness100

freshness100

hygiene80

+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. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://mcp.shelfclub.app/mcp` streamable-http	none	yes	100%	373 ms	2025-11-25	2026-10-19

Tools (6)

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

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "app.shelfclub/books",
  "title": "Shelfclub",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://mcp.shelfclub.app/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "0.2.0",
  "websiteUrl": "https://shelfclub.app",
  "description": "Search a catalog of 1.7 million books and find books by mood, vibe, pace or genre. Read-only."
}