MCP server

Shelfclub Official

app.shelfclub/books

Checked 28 Oct 2026, 09:03 UTC · Connected to it and listed its tools

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

Website

At a glance

Type

MCP server

Publisher

shelfclub.app (verified by the MCP Registry)

Status

Working at last check

Tools

6

Token cost

About 1,687 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

28 Oct 2026, 09:03 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

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

Gemini CLI

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

Cursor

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

VS Code

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

Antigravity

agy mcp add books https://mcp.shelfclub.app/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"books","server_url":"https://mcp.shelfclub.app/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"books","server_url":"https://mcp.shelfclub.app/mcp"}

Tools

• find_books_by_mood ~503 tokens
  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 book
• get_author ~280 tokens
  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
• get_book ~286 tokens
  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 b
• get_similar_books ~255 tokens
  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
• get_trending_books ~173 tokens
  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,
• search_books ~190 tokens
  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).

Related MCP servers

• tickadoo Experiences and Events
  Discover and book theatre, tours, attractions, and live experiences worldwide. No API key required.
• MusicAtlas
  Search, analyze, and discover commercially released music using sonic intelligence.
• StockCake
  Search millions of CC0 public-domain AI images: previews, dimensions, provenance, license.
• CareClinic Health Tracker
  Review schedules, symptoms, mood, and explicitly confirmed CareClinic check-ins.
• Zaps
  Photos and a brief in, finished social-media designs out. First design free, no account.
• Dim Hour
  Search 19,000+ verified places to eat and drink across 24 cities, each with a 0-100 quality score.
• Cwi Discovery Engine
  CWI Discovery Engine: 29-tool music catalog MCP — search, sync, Radio 365 live, chaining.
• Songs To Your Eyes — production music catalogue
  Search 18,594 production-music cues by mood, sound and exact runtime. Instant preview links.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/app.shelfclub/books.svg)](https://aptlynx.net/servers/app.shelfclub/books)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents