# annas-mcp

Search a vast catalog of books on Anna's Archive. Discover editions, formats, and metadata to quickly pinpoint the right copy. Download selected titles for fast, offline access.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add chris/annas-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list chris/annas-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get chris/annas-mcp download

# Call a tool
npx -y @smithery/cli@latest tool call chris/annas-mcp download '{}'
```

## Direct MCP Connection

Endpoint: `https://annas-mcp--chris.run.tools`

**Required config:**
- `secretKey` (query) — Your Anna's Archive API key for accessing the JSON API. Get one at https://annas-archive.org/faq#api

**Optional config:**
- `downloadPath` (query) — Path where downloaded documents will be stored

## Tools (2)

- `download` — Download a book by its MD5 hash. Requires ANNAS_SECRET_KEY/secretKey environment variable.
- `search` — Search books on Anna's Archive

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get chris/annas-mcp <tool-name>
```

---

Source: https://github.com/chrisgreenx-ctrl/annas-mcp