Myanonamouse Mcp

myanonamouse-mcp

An MCP (Model Context Protocol) server for MyAnonamouse (MAM), a private tracker specialising in audiobooks and ebooks. Exposes MAM search and user tools to any MCP-compatible client such as Claude Desktop.

Prerequisites

• A MyAnonamouse account
• Your mam_id session cookie (see [Authentication](#authentication) below)
• Rust toolchain (for building from source) — or download a pre-built binary from [Releases](../../releases)

Building from source

git clone https://github.com/sandymac/myanonamouse-mcp.git
cd myanonamouse-mcp
cargo build --release
# Binary is at target/release/myanonamouse-mcp

Authentication

MyAnonamouse authenticates via a session cookie named mam_id. There is no API key or OAuth flow — you copy the value directly from the site.

How to obtain your mam_id:

1. Log into MyAnonamouse in your browser
2. Go to Preferences → Security
3. Copy the value shown for mam_id

> The mam_id value is long and may contain an %3D which may need to be replaced with an = sign at the end. Use --test-connection to verify.

Supply the value via the --mam-session flag or the MAM_SESSION environment variable. The cookie expires periodically; if you get authentication errors, refresh it from Preferences → Security and verify it with --test-connection.

Session persistence (recommended)

MAM occasionally rotates the mam_id cookie on its responses. The server picks the rotated value up automatically while running, but without persistence it is lost on restart — and the original value you configured may no longer be valid. Pass --state-file (or set MAM_STATE_FILE) to keep the rotated cookie across restarts:

myanonamouse-mcp --mam-session  --state-file ~/.config/myanonamouse-mcp/state.json

On startup the stored (rotated) cookie is used instead of --mam-session/MAM_SESSION. If you supply a new cookie value, it takes precedence and replaces the stored one — so refreshing a dead cookie works exactly as before, no need to delete the state file. The file also stores OAuth client registrations and tokens when the embedded OAuth server is enabled. Keep it in a user-only directory: it contains your session cookie.

Quick start

Verify your session cookie works:

myanonamouse-mcp --mam-session  --test-connection

Run the server:

myanonamouse-mcp --mam-session 

Or set the environment variable to avoid passing the cookie on every invocation:

export MAM_SESSION=
myanonamouse-mcp

Claude Desktop setup

Add the server to your Claude Desktop configuration file.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "myanonamouse": {
      "command": "/path/to/myanonamouse-mcp",
      "args": ["--mam-session", "your_mam_id_here"]
    }
  }
}

Using an environment variable instead (recommended — keeps the cookie out of the process listing):

{
  "mcpServers": {
    "myanonamouse": {
      "command": "/path/to/myanonamouse-mcp",
      "env": {
        "MAM_SESSION": "your_mam_id_here"
      }
    }
  }
}

Restart Claude Desktop after editing the config.

Available tools

Run myanonamouse-mcp --list-tools to see all tools with their current default status.

| Tool | Default | Description | |---|---|---| | search_audiobooks | ✓ | Search audiobooks by title/author/narrator/series, genre, language | | search_ebooks | ✓ | Search ebooks by title/author/series, genre, language | | search_music | ✓ | Search musicology content (sheet music, tabs, instructional) by genre | | search_radio | ✓ | Search radio recordings by genre | | get_torrent_details | ✓ | Full details for one torrent by ID or hash | | get_ip_info | — | Check current IP and ASN as seen by MAM | | search_torrents | — | Cross-category power search with numeric category/language IDs | | list_categories | — | Full category and subcategory ID table for search_torrents | | get_user_data | — | User profile — stats, ratio, seed bonus, notifications | | get_user_bonus_history | — | Bonus point transaction history | | update_seedbox_ip | — | Register current IP as dynamic seedbox IP |

Tool groups

Tools are organised into groups to keep the default token footprint small. Enable only what you need.

| Group | Flag | Tools | When to use | |---|---|---|---| | default | (on by default) | search_audiobooks, search_ebooks, search_music, search_radio, get_torrent_details | Always available — read-only browsing and search | | power | --enable-power-tools | search_torrents, list_categories | Cross-category search using raw numeric IDs; useful when the per-category tools aren't flexible enough | | user | --enable-user-tools | get_user_data, get_user_bonus_history | Access to your account stats, ratio, and bonus point history | | seedbox | --enable-seedbox | update_seedbox_ip, get_ip_info | Registers your current IP as a dynamic seedbox IP on MAM; check IP/ASN as seen by MAM |

# Enable the cross-category power search tools
myanonamouse-mcp --mam-session  --enable-power-tools

# Enable user profile tools
myanonamouse-mcp --mam-session  --enable-user-tools

# Enable the seedbox IP registration tool
myanonamouse-mcp --mam-session  --enable-seedbox

# Enable a specific tool by name
myanonamouse-mcp --mam-session  --enable-tool=get_user_data

# Disable a default tool (e.g. restrict to ebooks only)
myanonamouse-mcp --mam-session  --disable-tool=search_audiobooks --disable-tool=search_music --disable-tool=search_radio

--disable-tool always wins over group and individual enable flags, regardless of the order flags appear on the command line.

HTTP transport

To use the HTTP/SSE transport for remote or agentic clients, start with --transport http:

myanonamouse-mcp --mam-session "mam_id" --transport http --http-bind 127.0.0.1:8080 --api-token "your-secret-token"

MCP clients connect to http://:8080/mcp. The --api-token flag is strongly recommended when binding to a network interface — without it, anyone who can reach the port can access the MCP endpoint.

Clients must include the token in every request when --api-token is set:

Authorization: Bearer your-secret-token

> For internet-facing deployments, put this behind a reverse proxy (nginx, Caddy, Traefik) that terminates TLS. The server itself does not handle HTTPS.

Tips for best results

• Use search_type: "active" to exclude dead torrents (no seeders)
• Use search_type: "fl" to find freeleech torrents — these don't count against your download ratio (though you must still seed to site requirements)
• Use sort: "most seeders" to surface the best-seeded results first
• Use sort: "newest" to find recently added content
• Use get_torrent_details after a search to get the full description, ISBN, media info, and all metadata for a specific torrent
• Use offset and limit to page through large result sets

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: sandymac
• Source: sandymac/myanonamouse-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.