annas-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ANNAS_SECRET_KEY | No | Your Anna's Archive API key. Needed for downloads. | |
| ANNAS_DOWNLOAD_PATH | No | Absolute folder for downloaded files. Needed for downloads. | |
| ANNAS_ACCOUNT_COOKIE | Yes | Your aa_account_id2 cookie from a signed-in Anna's Archive session. Needed for everything. |
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 |
|---|---|
| account_statusA | Show the account's membership and how many fast downloads it has left in its rolling window. Check it before downloading many files. |
| article_downloadA | Download a selected paper by exactly one of doi or hash. The hash field accepts a bare MD5 or an Anna's Archive /md5/ page URL. Resolves a DOI to its hash, then returns an existing file in ANNAS_DOWNLOAD_PATH if its full MD5 matches, otherwise downloads under a unique name. Returns path and bytes; downloads_left is omitted on local reuse. Optional title and format control a new file's name. |
| article_searchA | Find a paper by DOI (including DOI URLs), or search journal articles by keywords, author, title or year. DOI lookup returns one paper; keyword search returns one page. Set include_stats to add public per-file downloads, quality votes, reports, lists and comments. Compare metadata before downloading by hash or DOI. |
| book_detailsA | Get the full record for a search hit: ISBNs, DOI, OCLC and other identifiers, edition, year, full description, subjects, alternative titles, problems reported for the file, and download and quality counts. Accepts a hash from book_search or article_search, or an id from metadata_search. |
| book_downloadA | Download the selected book using its MD5 hash or Anna's Archive /md5/ page URL in hash. Returns an existing file in ANNAS_DOWNLOAD_PATH if its full MD5 matches, otherwise downloads a verified copy under a unique name. Returns path and bytes; downloads_left is omitted on local reuse. Format sets the extension; it does not convert the file. |
| book_searchA | Search books, textbooks, manuals and standards by title, author or topic, optionally filtered by format, language, content type, source library or year and sorted. Returns one page with hash, format, year, fast_download and metadata. Set include_stats to add public per-file downloads, quality votes, reports, lists and comments. Pass a selected hash to book_download, or to book_details for ISBNs, edition and file problems. |
| metadata_searchA | Search library catalogs (Open Library, WorldCat, ISBNdb, Goodreads, Google Books and others) for books, including ones with no downloadable file. Use it to find ISBNs, editions and publication details, then search book_search by ISBN or title for files. Pass an id to book_details for identifiers. |
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 7 tools
Each tool targets a distinct resource+action: account_status for quota, article_search/article_download for papers, book_search/book_download/book_details for books, and metadata_search for catalog lookups. The only real overlap is between book_search and metadata_search, which both find book information, but the descriptions clearly separate file-bearing results from pure metadata.
All tools use consistent snake_case noun_action naming (account_status, article_download, article_search, book_details, book_download, book_search, metadata_search). The resource-first convention is predictable and readable throughout.
Seven tools is well within the ideal 3-15 range and each one earns its place, covering quota, search, details, and download for both books and articles plus a metadata path. No redundant or trivial tools.
The surface covers the core lifecycle for the domain: check quota, search books and papers, fetch details, and download both resource types. Minor gaps exist, such as no bulk/batch download or browsing recent additions, but core workflows are fully supported without dead ends.