Schema | opds-mcp

opds-mcp

Describes the environment variables required to run the server.

Name	Required	Description
`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.

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.

Features and capabilities supported by this server

Protocol revision2025-11-25

Capability	Details
`tools`	{ "listChanged": true }

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 `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.

Interactive templates invoked by user choice

Name	Description
No prompts

Contextual data attached and managed by the client

Name	Description
No resources

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