opds-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OPDS_BASE_URL | No | The catalog URL used when a tool call doesn't pass its own url. This is the recommended way to point the server at a specific library. | |
| OPDS_PASSWORD | No | Used as a fallback for HTTP Basic Auth when a tool call doesn't pass its own credentials. | |
| OPDS_USERNAME | No | Used as a fallback for HTTP Basic Auth when a tool call doesn't pass its own credentials. | |
| OPDS_DOWNLOAD_DIR | No | Where opds_download saves files; defaults to a directory under the OS temp folder. |
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
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| opds_browseB | Fetches an OPDS catalog document (feed, navigation, or acquisition list; OPDS 1.x Atom/XML or OPDS 2.0 JSON) and returns its navigation links (search, next/prev, subsections) and entries (books/publications) with their acquisition (download) and cover image links. |
| opds_searchA | Searches an OPDS catalog. Pass either the catalog's root/feed URL (its OpenSearch description will be discovered via the feed's rel="search" link) or an OpenSearchDescription document URL directly, plus a free-text query. Returns matching entries the same way opds_browse does. |
| opds_get_entryA | Fetches a single OPDS entry document (a per-publication Atom entry or OPDS 2.0 publication), typically the URL found in an entry's rel="alternate" link, and returns its full details including acquisition links. |
| opds_downloadA | Downloads the file behind an OPDS acquisition link (as returned in the |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool has a distinct purpose: opds_browse for navigation, opds_search for queries, opds_get_entry for detailed entry info, and opds_download for file retrieval. There is no overlap or ambiguity.
All tool names follow a consistent opds_verb_noun pattern (opds_browse, opds_download, opds_get_entry, opds_search), making the set predictable and easy to understand.
With exactly 4 tools, the server covers the essential operations for an OPDS client (browse, search, get entry, download) without being excessive or insufficient.
The tool set provides complete coverage for interacting with an OPDS catalog: navigating feeds, searching, retrieving detailed entry information, and downloading files. No obvious gaps for client-side operations.