Skip to main content
Glama
mickeiik

liseur-mcp

by mickeiik
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MCP_HOSTNoHost for HTTP listener127.0.0.1
MCP_PATHNoPath for HTTP listener/mcp
MCP_PORTNoPort for HTTP listener8000
LISEUR_URLYesBase URL of the instance
LISEUR_TOKENNoDevice token secret
MCP_TRANSPORTNoTransport mode: stdio or streamable-httpstdio
MCP_AUTH_TOKENNoBearer token for HTTP transport (required when MCP_TRANSPORT=streamable-http)
LISEUR_TOKEN_FILENoPath to file containing device token secret
MCP_ALLOWED_HOSTSNoAllowed Host headers for HTTP transportlocalhost
MCP_AUTH_TOKEN_FILENoPath to file containing bearer token for HTTP transport
LISEUR_TIMEOUT_SECONDSNoUpstream request timeout in seconds30

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

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

Tools

Functions exposed to the LLM to take actions

NameDescription
list_foldersA

List the library folders this account can read.

    Each folder carries a folder_id to pass to list_books and search_books.
list_booksA

List books in one folder.

    order: "recent" (newest first, default) or "oldest". limit: 1-200.
    Returns full catalog records: book_id, title, contributors, series, tags.
search_booksA

Search titles, descriptions, series, contributors and tags.

    Searches every folder when folder_id is omitted. Results are best
    matches per folder, not alphabetically ordered.
get_bookA

Fetch one catalog record by book_id (same shape list_books returns).

reading_statsA

Reading totals, streak and pace over a span, plus per-work rows.

    range is a number of days ("7d", "30d") or "all". Per-work rows are
    ordered by time read and capped at 50; current_progression is always
    the latest position regardless of the span.
list_highlightsA

List highlights, notes and bookmarks.

    With book_id: the annotations of that book. The first call joins the
    catalog book to your reading work — a per-user mapping; nothing shared
    changes. Without book_id: every live annotation on the account, each
    carrying its work_id.
get_book_textA

Read the text of a book, one chapter at a time.

    Without chapter: returns the table of contents (index, title, chars).
    With chapter: that chapter's text, cut to max_chars from offset;
    next_offset continues when the chapter is longer. The EPUB is
    downloaded from the server and parsed on each call.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4/5.0

Scored across 7 tools

Disambiguation5/5

Each tool maps to a distinct resource or action: folders, catalog records, book lists, search, stats, highlights, and full text. Even the similarly named get_book and get_book_text are clearly separated by descriptions (metadata vs. chapter text).

Naming Consistency4/5

Most tools follow a verb_noun snake_case pattern (list_books, search_books, get_book_text). reading_stats is the one outlier as a noun phrase, so the pattern is not perfectly uniform.

Tool Count5/5

Seven tools is a well-scoped size for a reading/librarian server. Each tool covers a meaningful part of the workflow without redundancy.

Completeness4/5

The surface covers discovery, metadata, text access, highlights, and reading statistics, which are the core read-only operations. Minor gaps exist around pagination/limits for large catalogs or highlight lists, but agents can usually work around them.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources