Skip to main content
Glama
Palanx

grimoire-beholder-mcp

by Palanx

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LIBRARY_DIRYesAbsolute path to the directory containing config.toml and book.db
PROJECT_DIRYesAbsolute path to the grimoire-beholder-mcp project directory (where uv sync was run)

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_booksA

List every book in the library, with its id, slug, name, author, type, and page count.

get_book_outlineA

Return one book's chapter/section outline -- the map for get_section.

Lists every chapter (chapter_index, title, page_start) and, nested under each, its sections (section_index, title, page_start, approx_tokens). Auto-split sections have no native title; one is synthesized from a text snippet so it's still identifiable. Returns no section text -- that's get_section's job; this is just the map.

Typical flow: list_books -> get_book_outline(book_id) -> get_section( book_id, chapter_index, section_index) for targeted reading. Use search_book instead when you don't already know which section to read.

search_bookA

Search the library and return cited, scored excerpts.

Combines semantic and keyword search by default. Optionally scope to one book (book_id), or filter by exact author or source_type (one of "pdf", "epub", "markdown", "text").

get_sectionB

Fetch one section's full text and summary.

The parent of a search_book hit, or a section located via get_book_outline's chapter_index/section_index map.

book_statusA

Report ingest status (chapter/section counts, chunk counts per stage) for every book.

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/Palanx/grimoire-beholder-mcp'

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