SPINES MCP Server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SPINES_DEBUG | No | Verbose logging to stderr | false |
| SPINES_API_KEY | Yes | Your SPINES API key. Required. Get one at https://getspines.com/settings/developer | |
| SPINES_API_URL | No | API base URL | https://getspines.com/api/v1 |
| SPINES_LLM_API_KEY | No | Your provider API key. With both set, recognition uses your key and no SPINES credits | |
| SPINES_LLM_PROVIDER | No | Bring your own LLM key for `recognize_bookshelf`; only `gemini` is accepted. Set together with `SPINES_LLM_API_KEY` |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_booksB | Search for books by title, author, or ISBN |
| get_book_detailsC | Get full details for a specific book |
| get_collectionA | Get a book collection with all its books |
| list_collectionsC | List the user's collections with optional filters |
| list_categoriesB | List all approved book categories |
| get_personaC | Get details about a persona (bookshelf owner) |
| add_to_reading_listC | Add a book to a reading list |
| remove_from_reading_listC | Remove a book from a reading list |
| check_creditsA | Check your daily recognition credit balance |
| get_book_pairingsA | Find books commonly co-shelved with a specific book (Shelfology) |
| recognize_bookshelfA | Recognize books from one or more photos of a bookshelf; several photos become one collection (uses daily credits or BYOK) |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| analyze_shelf | |
| recommend_books | |
| compare_collections |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Collection | A book collection with its books and metadata |
| Book | Full book metadata (title, author, ISBN, cover, editions) |
| Persona | A persona's profile and their collections |
| Reading Lists | The user's reading lists with book details |
TDQS
Scored across 11 tools
Each tool targets a distinct resource or action: searching books, retrieving details, recognizing photos, managing collections, reading lists, personas, categories, and credits. No two tools have overlapping purposes that could cause misselection.
All tool names follow a consistent snake_case verb_noun pattern: get_book_pairings, recognize_bookshelf, search_books, get_book_details, get_collection, list_collections, list_categories, get_persona, add_to_reading_list, remove_from_reading_list, check_credits.
11 tools is well within the ideal range of 3–15 and each tool earns its place for the book discovery and collection management domain. No tool feels redundant or missing from a count perspective.
Notable gaps exist: there is no way to view a reading list (only add/remove), no update or delete operations for collections, and no list of personas. These missing lifecycle operations could hinder agents from verifying state or managing resources fully.