torrentclaw/torrentclaw-mcp
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Model Context Protocol server for TorrentClaw search/download
3 commits 2 branches 5 tags 157 KiB
Find a file
Deivid Soto bf459740fe feat: add response cache and compact output mode 
Response cache (api-client.ts):
- In-memory TTL cache (5 min default) avoids duplicate API calls
  when LLMs repeat the same tool call within a conversation.
- Cache key = full URL with params; only 200 OK responses are cached.
- Exposed via client.cache for manual clear() if needed.
- Configurable TTL via TorrentClawClient constructor.

Compact mode (search_content tool):
- New compact boolean parameter (default: false).
- When true, magnet links use short form magnet:?xt=urn:btih:{hash}
  (~60 chars) instead of full magnets with trackers (~300 chars).
- Short magnets are still valid and clickable (DHT peer discovery).
- Also generates a magnet from info_hash even when API returns null.
- Saves ~10K chars per typical search (5 torrents x 10 results).

Tests: 100 total (15 new), all passing.
2026-02-09 17:57:11 +01:00
src feat: add response cache and compact output mode 2026-02-09 17:57:11 +01:00
tests feat: add response cache and compact output mode 2026-02-09 17:57:11 +01:00
.gitignore feat: initial release of torrentclaw-mcp server 2026-02-09 17:26:23 +01:00
LICENSE feat: initial release of torrentclaw-mcp server 2026-02-09 17:26:23 +01:00
package-lock.json feat: initial release of torrentclaw-mcp server 2026-02-09 17:26:23 +01:00
package.json feat: initial release of torrentclaw-mcp server 2026-02-09 17:26:23 +01:00
README.md fix: correct README inconsistencies and add TORRENTCLAW_ALLOW_PRIVATE 2026-02-09 17:46:24 +01:00
tsconfig.json feat: initial release of torrentclaw-mcp server 2026-02-09 17:26:23 +01:00
vitest.config.ts feat: initial release of torrentclaw-mcp server 2026-02-09 17:26:23 +01:00

README.md

torrentclaw-mcp

MCP server for TorrentClaw — search movies and TV shows with torrent download options, streaming availability, and metadata.

Quick Start

npx torrentclaw-mcp

No API key required.

Available Tools

Tool Description
search_content Search movies/shows with filters (query, type, genre, year, rating, quality, language, sort). Returns content with torrents and magnet links.
get_popular Get popular content ranked by user clicks
get_recent Get recently added content
get_watch_providers Streaming availability by country (Netflix, Disney+, etc.)
get_credits Cast and director for a title
get_torrent_url Get .torrent file download URL from info hash

Resources

URI Description
torrentclaw://stats Catalog statistics (content/torrent counts by source)

Prompts

Prompt Description
search_movie Search for a movie by title and get torrents + streaming
search_show Search for a TV show by title and get torrents
whats_new Discover recently added movies and TV shows
where_to_watch Find where to stream, rent, or buy a title

Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "torrentclaw": {
      "command": "npx",
      "args": ["-y", "torrentclaw-mcp"]
    }
  }
}

Claude Code

Add to .mcp.json or ~/.claude/settings.json:

{
  "mcpServers": {
    "torrentclaw": {
      "command": "npx",
      "args": ["-y", "torrentclaw-mcp"]
    }
  }
}

Self-hosted

Point to your own TorrentClaw instance:

{
  "mcpServers": {
    "torrentclaw": {
      "command": "npx",
      "args": ["-y", "torrentclaw-mcp"],
      "env": {
        "TORRENTCLAW_API_URL": "http://localhost:3030",
        "TORRENTCLAW_ALLOW_PRIVATE": "true"
      }
    }
  }
}

Environment Variables

Variable Default Description
TORRENTCLAW_API_URL https://torrentclaw.com Base URL of the TorrentClaw API
TORRENTCLAW_ALLOW_PRIVATE false Set to true to allow private/localhost URLs (for self-hosted setups)

Development

git clone https://github.com/buryni/torrentclaw-mcp.git
cd torrentclaw-mcp
npm install
npm run build

Test with MCP Inspector:

npx @modelcontextprotocol/inspector node build/index.js

Run tests:

npm test

License

MIT