English Français العربية

Torrentclaw MCP

Community Search and web

Search and discover movies and TV shows with torrent links, quality scoring, streaming availability and cast/crew metadata.

Source code Documentation

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. torrentclaw-mcp
  2. Quick Start
  3. What can it do?
  4. Configuration
  5. Project Structure
  6. Development
  7. About TorrentClaw
  8. Contributing
  9. License

torrentclaw-mcp

Model Context Protocol server for TorrentClaw — giving AI assistants the ability to search movies and TV shows, find torrents with magnet links, check streaming availability, and explore cast/crew metadata.

torrentclaw-mcp is developed by TorrentClaw as part of its open-source ecosystem. It wraps the TorrentClaw API into the MCP standard so that any compatible AI assistant (Claude, GPT, etc.) can access the platform's search and discovery features natively.

Quick Start

npx torrentclaw-mcp

No API key required (optional for higher rate limits).

What can it do?

Tools
ToolDescription
search_contentSearch movies/shows with filters (query, type, genre, year, rating, quality, language, audio, HDR, season, episode, sort). Returns torrents, magnet links, and optional streaming info.
autocompleteType-ahead search suggestions (up to 8 results). Use to validate titles before a full search.
get_popularGet popular content ranked by user clicks
get_recentGet recently added content
get_watch_providersStreaming availability by country (Netflix, Disney+, etc.)
get_creditsCast and director for a title
get_torrent_urlGet .torrent file download URL from info hash
track_interactionTrack user interaction with a torrent (magnet click, download, copy)
submit_scan_requestSubmit a torrent for audio/video quality analysis via TrueSpec
get_scan_statusCheck the status of a torrent scan request
Resources
URIDescription
torrentclaw://statsCatalog statistics (content/torrent counts by source)
Prompts
PromptDescription
search_movieSearch for a movie by title and get torrents + streaming
search_showSearch for a TV show by title and get torrents
whats_newDiscover recently added movies and TV shows
where_to_watchFind 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"]
    }
  }
}
Environment Variables
VariableDefaultDescription
TORRENTCLAW_API_URLhttps://torrentclaw.comBase URL of the TorrentClaw API
TORRENTCLAW_API_KEY(none)Optional API key for authenticated access (higher rate limits)

Project Structure

.
├── src/
│   ├── index.ts              # MCP server entry point
│   ├── config.ts             # Configuration & URL validation
│   ├── api-client.ts         # TorrentClaw API client with caching
│   ├── types.ts              # TypeScript interfaces for API responses
│   ├── prompts.ts            # MCP prompt definitions
│   ├── tools/                # MCP tool implementations
│   │   ├── search-content.ts
│   │   ├── autocomplete.ts
│   │   ├── get-popular.ts
│   │   ├── get-recent.ts
│   │   ├── get-watch-providers.ts
│   │   ├── get-credits.ts
│   │   ├── get-torrent-url.ts
│   │   ├── track-interaction.ts
│   │   └── scan-request.ts
│   ├── formatters/           # Output formatting
│   │   ├── content.ts
│   │   ├── providers.ts
│   │   └── credits.ts
│   └── resources/            # MCP resources
│       └── stats.ts
├── tests/                    # Test suite (vitest)
├── .github/workflows/        # CI/CD (lint, build, test, release)
├── lefthook.yml              # Git hooks (commit lint, prettier, tsc)
├── Makefile                  # Dev workflow (build, test, lint, fmt)
├── CONTRIBUTING.md           # Contribution guidelines
├── LICENSE                   # MIT
└── README.md

Development

git clone https://github.com/torrentclaw/torrentclaw-mcp.git
cd torrentclaw-mcp
make install-tools
make hooks
make build && make test

Test with MCP Inspector:

npx @modelcontextprotocol/inspector node build/index.js

About TorrentClaw

TorrentClaw is an open platform focused on improving the quality and reliability of torrent metadata. Our mission is to make torrent search engines more accurate and the torrent ecosystem healthier — by building tools that verify, enrich, and standardize metadata across the network.

torrentclaw-mcp is part of the TorrentClaw open-source ecosystem, alongside TrueSpec (torrent metadata verification).

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT License — see LICENSE for details.

Frequently asked questions

What is Torrentclaw MCP?

Search and discover movies and TV shows with torrent links, quality scoring, streaming availability and cast/crew metadata.

How do I install Torrentclaw MCP?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is Torrentclaw MCP open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Torrentclaw MCP?

It is published by torrentclaw. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.