Download a publication from an OPDS acquisition link
opds_downloadDownloads a file from an OPDS acquisition link to a local directory and returns the saved file path.
Instructions
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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "opds_download"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Absolute URL of the acquisition (download) link | |
| password | No | HTTP Basic Auth password, if the catalog requires authentication | |
| username | No | HTTP Basic Auth username, if the catalog requires authentication | |
| suggestedName | No | Preferred base file name (without extension), e.g. the book title |