Skip to main content
Glama
pastukhov

opds-mcp

by pastukhov

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
OPDS_BASE_URLNoThe 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_PASSWORDNoUsed as a fallback for HTTP Basic Auth when a tool call doesn't pass its own credentials.
OPDS_USERNAMENoUsed as a fallback for HTTP Basic Auth when a tool call doesn't pass its own credentials.
OPDS_DOWNLOAD_DIRNoWhere opds_download saves files; defaults to a directory under the OS temp folder.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 acquisitions array of opds_browse/opds_search/opds_get_entry) to a local directory and returns the saved file path. Defaults to a directory under the OS temp folder (/tmp/opds-mcp-downloads); configure OPDS_DOWNLOAD_DIR to persist elsewhere.

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/pastukhov/opds-mcp'

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