Skip to main content
Glama
SavageCore
by SavageCore

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
BOOKSHELF_URLYesThe base URL of the Bookshelf instance, e.g. http://your-bookshelf-host:8787
BOOKSHELF_API_KEYNoAPI key for authentication via X-Api-Key header. Optional for startup but required for all API endpoints.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
extensions
{
  "io.modelcontextprotocol/ui": {}
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
bookshelf_list_authorC

List author.

bookshelf_create_authorB

Create author. WRITE: this modifies your Bookshelf instance.

bookshelf_update_authorC

Update author. Query params: moveFiles. WRITE: this modifies your Bookshelf instance.

bookshelf_delete_authorB

Delete author. Query params: deleteFiles, addImportListExclusion. DESTRUCTIVE: this deletes data.

bookshelf_get_authorA

Fetch a single author by id.

bookshelf_bulk_update_authorC

Bulk update author editor. WRITE: this modifies your Bookshelf instance.

bookshelf_bulk_delete_authorC

Bulk delete author editor. DESTRUCTIVE: this deletes data.

bookshelf_lookup_authorA

Search the metadata provider for authors by term.

bookshelf_list_system_backupA

List system backup.

bookshelf_delete_system_backupB

Delete system backup. DESTRUCTIVE: this deletes data.

bookshelf_restore_backupD

Create system backup restore. WRITE: this modifies your Bookshelf instance.

bookshelf_restore_backup_uploadC

Create system backup restore upload. WRITE: this modifies your Bookshelf instance.

bookshelf_list_blocklistC

List blocklist. Query params: page, pageSize, sortKey, sortDirection.

bookshelf_delete_blocklistC

Delete blocklist. DESTRUCTIVE: this deletes data.

bookshelf_bulk_delete_blocklistC

Bulk delete blocklist bulk. DESTRUCTIVE: this deletes data.

bookshelf_list_bookD

List book. Query params: authorId, bookIds, titleSlug, includeAllAuthorBooks.

bookshelf_create_bookC

Create book. WRITE: this modifies your Bookshelf instance.

bookshelf_get_book_overviewB

Fetch a single book overview by id.

bookshelf_update_bookC

Update book. WRITE: this modifies your Bookshelf instance.

bookshelf_delete_bookB

Delete book. Query params: deleteFiles, addImportListExclusion. DESTRUCTIVE: this deletes data.

bookshelf_get_bookA

Fetch a single book by id.

bookshelf_update_books_monitoredA

Set the monitored state of books in bulk. Body is a BooksMonitoredResource with bookIds and monitored.

bookshelf_bulk_update_bookC

Bulk update book editor. WRITE: this modifies your Bookshelf instance.

bookshelf_bulk_delete_bookC

Bulk delete book editor. DESTRUCTIVE: this deletes data.

bookshelf_list_bookfileC

List bookfile. Query params: authorId, bookFileIds, bookId, unmapped.

bookshelf_update_bookfileC

Update bookfile. WRITE: this modifies your Bookshelf instance.

bookshelf_delete_bookfileC

Delete bookfile. DESTRUCTIVE: this deletes data.

bookshelf_get_bookfileA

Fetch a single bookfile by id.

bookshelf_bulk_update_bookfileB

Bulk update bookfile editor. WRITE: this modifies your Bookshelf instance.

bookshelf_bulk_delete_bookfileC

Bulk delete bookfile bulk. DESTRUCTIVE: this deletes data.

bookshelf_lookup_bookC

Search the metadata provider for books by term.

bookshelf_add_books_to_shelfB

Add the given books to a Goodreads/Hardcover shelf. Body is a BookshelfResource with bookshelfId and bookIds.

bookshelf_list_calendarC

List calendar. Query params: start, end, unmonitored, includeAuthor.

bookshelf_get_calendarB

Fetch a single calendar by id.

bookshelf_run_commandA

Run a Bookshelf command (body is a CommandResource with a name, e.g. RefreshAuthor, AuthorSearch, BookSearch, DownloadedBooksScan, RenamedBookFiles, RescanFolders, MetadataRefresh). WRITE: this modifies your Bookshelf instance.

bookshelf_list_commandC

List command.

bookshelf_delete_commandC

Delete command. DESTRUCTIVE: this deletes data.

bookshelf_get_commandA

Fetch a single command by id.

bookshelf_list_customfilterC

List customfilter.

bookshelf_create_customfilterB

Create customfilter. WRITE: this modifies your Bookshelf instance.

bookshelf_update_customfilterC

Update customfilter. WRITE: this modifies your Bookshelf instance.

bookshelf_delete_customfilterC

Delete customfilter. DESTRUCTIVE: this deletes data.

bookshelf_get_customfilterA

Fetch a single customfilter by id.

bookshelf_create_customformatC

Create customformat. WRITE: this modifies your Bookshelf instance.

bookshelf_list_customformatC

List customformat.

bookshelf_update_customformatB

Update customformat. WRITE: this modifies your Bookshelf instance.

bookshelf_delete_customformatB

Delete customformat. DESTRUCTIVE: this deletes data.

bookshelf_get_customformatA

Fetch a single customformat by id.

bookshelf_get_customformat_schemaC

List customformat schema.

bookshelf_list_wanted_cutoffC

List wanted cutoff. Query params: page, pageSize, sortKey, sortDirection, includeAuthor, monitored.

bookshelf_get_wanted_cutoffA

Fetch a single wanted cutoff by id.

bookshelf_create_delayprofileC

Create delayprofile. WRITE: this modifies your Bookshelf instance.

bookshelf_list_delayprofileB

List delayprofile.

bookshelf_delete_delayprofileC

Delete delayprofile. DESTRUCTIVE: this deletes data.

bookshelf_update_delayprofileC

Update delayprofile. WRITE: this modifies your Bookshelf instance.

bookshelf_get_delayprofileA

Fetch a single delayprofile by id.

bookshelf_reorder_delayprofileC

Update delayprofile reorder. Query params: afterId. WRITE: this modifies your Bookshelf instance.

bookshelf_get_config_developmentC

List config development.

bookshelf_update_config_developmentC

Update config development. WRITE: this modifies your Bookshelf instance.

bookshelf_get_config_development_by_idA

Fetch a single config development by id.

bookshelf_get_diskspaceB

List diskspace.

bookshelf_list_downloadclientC

List downloadclient.

bookshelf_create_downloadclientA

Create downloadclient. Query params: forceSave. WRITE: this modifies your Bookshelf instance.

bookshelf_update_downloadclientC

Update downloadclient. Query params: forceSave. WRITE: this modifies your Bookshelf instance.

bookshelf_delete_downloadclientC

Delete downloadclient. DESTRUCTIVE: this deletes data.

bookshelf_get_downloadclientA

Fetch a single downloadclient by id.

bookshelf_bulk_update_downloadclientC

Bulk update downloadclient bulk. WRITE: this modifies your Bookshelf instance.

bookshelf_bulk_delete_downloadclientC

Bulk delete downloadclient bulk. DESTRUCTIVE: this deletes data.

bookshelf_get_downloadclient_schemaB

List downloadclient schema.

bookshelf_test_downloadclientD

Create downloadclient test. Query params: forceTest. WRITE: this modifies your Bookshelf instance.

bookshelf_test_all_downloadclientC

Create downloadclient testall. WRITE: this modifies your Bookshelf instance.

bookshelf_action_downloadclientD

Create downloadclient action. WRITE: this modifies your Bookshelf instance.

bookshelf_get_config_downloadclientC

List config downloadclient.

bookshelf_update_config_downloadclientD

Update config downloadclient. WRITE: this modifies your Bookshelf instance.

bookshelf_get_config_downloadclient_by_idB

Fetch a single config downloadclient by id.

bookshelf_list_editionC

List edition. Query params: bookId.

bookshelf_list_filesystemC

List filesystem. Query params: path, includeFiles, allowFoldersWithoutTrailingSlashes.

bookshelf_list_filesystem_typeC

List filesystem type. Query params: path.

bookshelf_list_filesystem_mediafilesC

List filesystem mediafiles. Query params: path.

bookshelf_get_healthC

List health.

bookshelf_list_historyC

List history. Query params: page, pageSize, sortKey, sortDirection, includeAuthor, includeBook, eventType, bookId, downloadId.

bookshelf_list_history_sinceC

List history since. Query params: date, eventType, includeAuthor, includeBook.

bookshelf_list_history_authorD

List history author. Query params: authorId, bookId, eventType, includeAuthor, includeBook.

bookshelf_mark_history_failedA

Mark a history event as failed and trigger a re-search. WRITE: this modifies your Bookshelf instance.

bookshelf_get_config_hostC

List config host.

bookshelf_update_config_hostB

Update config host. WRITE: this modifies your Bookshelf instance.

bookshelf_get_config_host_by_idB

Fetch a single config host by id.

bookshelf_list_importlistB

List importlist.

bookshelf_create_importlistC

Create importlist. Query params: forceSave. WRITE: this modifies your Bookshelf instance.

bookshelf_update_importlistC

Update importlist. Query params: forceSave. WRITE: this modifies your Bookshelf instance.

bookshelf_delete_importlistC

Delete importlist. DESTRUCTIVE: this deletes data.

bookshelf_get_importlistB

Fetch a single importlist by id.

bookshelf_bulk_update_importlistD

Bulk update importlist bulk. WRITE: this modifies your Bookshelf instance.

bookshelf_bulk_delete_importlistC

Bulk delete importlist bulk. DESTRUCTIVE: this deletes data.

bookshelf_get_importlist_schemaA

List importlist schema.

bookshelf_test_importlistC

Create importlist test. Query params: forceTest. WRITE: this modifies your Bookshelf instance.

bookshelf_test_all_importlistC

Create importlist testall. WRITE: this modifies your Bookshelf instance.

bookshelf_action_importlistC

Create importlist action. WRITE: this modifies your Bookshelf instance.

bookshelf_list_importlistexclusionA

List importlistexclusion.

bookshelf_create_importlistexclusionC

Create importlistexclusion. WRITE: this modifies your Bookshelf instance.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/SavageCore/bookshelf-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server