Spines
Connects your AI assistant to the SPINES book platform via their REST API. Exposes search by title, author, or ISBN, plus tools to browse collections filtered by persona or category. You can add and remove books from reading lists, fetch full book details, and access pre-built prompts for shelf analysis and recommendations. Requires a SPINES API key from their developer settings. Useful if you're building reading workflows, managing book collections programmatically, or want your assistant to query and modify your SPINES library without switching contexts.
- tools
- 11
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Oct 14, 2026
Tools
11 toolsPublic tool metadata for what this MCP can expose to an agent.
search_booksSearch for books by title, author, or ISBN
Search for books by title, author, or ISBN
No parameter schema in public metadata yet.
get_book_detailsGet full details for a specific book
Get full details for a specific book
No parameter schema in public metadata yet.
get_collectionGet a book collection with all its books
Get a book collection with all its books
No parameter schema in public metadata yet.
list_collectionsList your collections with optional filters
List your collections with optional filters
No parameter schema in public metadata yet.
list_categoriesList all approved book categories
List all approved book categories
No parameter schema in public metadata yet.
get_personaGet details about a persona
Get details about a persona
No parameter schema in public metadata yet.
get_book_pairingsFind books commonly shelved together with a book (Shelfology)
Find books commonly shelved together with a book (Shelfology)
No parameter schema in public metadata yet.
check_creditsCheck your daily recognition credit balance
Check your daily recognition credit balance
No parameter schema in public metadata yet.
add_to_reading_listAdd a book to a reading list
Add a book to a reading list
No parameter schema in public metadata yet.
remove_from_reading_listRemove a book from a reading list
Remove a book from a reading list
No parameter schema in public metadata yet.
recognize_bookshelfRecognize books from one or more bookshelf photos and save them as a collection (uses credits)
Recognize books from one or more bookshelf photos and save them as a collection (uses credits)
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
SPINES_API_KEY*secretYour SPINES API key
Readme
SPINES MCP Server
Access SPINES book collections, reading lists, and bookshelf data from AI assistants via the Model Context Protocol.
Features
- Recognize books from photos of a bookshelf; several photos of one shelf become one collection
- Search books by title, author, or ISBN
- Browse and filter book collections
- Manage reading lists (add and remove books)
- Explore personas, categories, and books commonly shelved together
- AI prompts for shelf analysis and book recommendations
Quick Start
Prerequisites
- Node.js 18+
- A SPINES API key (get one here)
Installation
npm install -g @spines/mcp-server
Configuration
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"spines": {
"command": "npx",
"args": ["-y", "@spines/mcp-server"],
"env": {
"SPINES_API_KEY": "gtspn_live_your_key_here"
}
}
}
}
VS Code / Cursor
Add to your MCP settings:
Details
- Repository
- github.com/getspines/mcp-server
- Package
@spines/mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active