Your AI, Connected to 30+ Sources
Install the MCP server and let Claude, Cursor, Windsurf, or any AI agent search and analyze torrents for you.
Compatible with
Claude
Cursor
Windsurf
Cline
Roo Code
OpenClaw
Continue
ZedGet Started in 3 Steps
Choose your AI client and follow the instructions to connect TorrentClaw.
Install Node.js
Make sure you have Node.js 18+ installed on your system.
Add to configuration
~/Library/Application Support/Claude/claude_desktop_config.json
Restart and verify
Restart your AI client. You should see 4 new tools: search_torrents, get_stats, get_torrent_file, autocomplete.
{
"mcpServers": {
"torrentclaw": {
"command": "npx",
"args": ["-y", "@torrentclaw/mcp"],
"env": {
"BASE_URL": "https://torrentclaw.com"
}
}
}
}4 Tools, One Protocol
Search, filter, and access torrent metadata from any MCP client.
search_torrents
Search movies and TV shows with advanced filters (genre, year, quality, rating, language).
search_torrents({
q: "Big Buck Bunny",
quality: "1080p",
sort: "seeders"
})Found 5 torrents for "Big Buck Bunny" Best match: Big Buck Bunny (2008) Quality: 1080p • x264 • BluRay Size: 276 MB • Seeders: 312 Score: 78/100
get_stats
Get real-time statistics about the aggregator (content count, sources, recent ingestions).
get_stats()📊 TorrentClaw Statistics Movies: 72,845 | Shows: 18,234 Torrents: 1,247,392 Sources: YTS, EZTV, Knaben, Torrentio... Last update: 2 minutes ago
get_torrent_file
Generate a download URL for a .torrent file by its info hash.
get_torrent_file(
"dd8255ecdc7ca55f..."
)✅ Torrent file URL generated https://torrentclaw.com/api/v1/torrent/dd8255ecdc7ca55f... File: Big.Buck.Bunny.2008.1080p.BluRay.x264.torrent Ready to view
autocomplete
Get typeahead search suggestions ranked by popularity.
autocomplete({
q: "big buck"
})💡 Suggestions: 1. Big Buck Bunny (2008) — Movie 2. Big Fish (2003) — Movie 3. Big Hero 6 (2014) — Movie 4. The Big Lebowski (1998) — Movie
What You Can Do
See the MCP server in action with real-world examples.
"Find the best quality torrent for Big Buck Bunny"
Client Compatibility
Works with all MCP-compatible AI clients and editors.
| Client | Search Torrents | Get Statistics | Download Files | Autocomplete | Status |
|---|---|---|---|---|---|
Claude Desktop macOS, Windows | Stable | ||||
Cursor macOS, Windows, Linux | Stable | ||||
Windsurf macOS, Windows | Stable | ||||
Cline VS Code | Stable | ||||
Roo Code VS Code | Stable | ||||
OpenClaw CLI, Terminal | Stable | ||||
Continue VS Code, JetBrains | Beta | ||||
 Open Code VS Code | Beta | ||||
 Kilo Code macOS, Linux | Beta | ||||
Zed macOS, Linux | Soon |
All features work identically across all stable clients. Beta clients may have limited functionality. Coming soon clients are planning MCP support.
Supported Platforms
Frequently Asked Questions
Everything you need to know about the TorrentClaw MCP server.
Model Context Protocol (MCP) is an open standard that lets AI agents connect to external tools and data sources. It was created by Anthropic and is supported by Claude Desktop, Cursor, Windsurf, and other AI clients.
With MCP, you can extend your AI agent's capabilities by connecting it to APIs, databases, and services — like TorrentClaw.
Currently, MCP is supported by Claude Desktop, Cursor, Windsurf, Cline (VS Code extension), and Continue (beta). More clients are adding support.
Check the compatibility matrix above for the full list of supported clients and their status.
Yes! The TorrentClaw MCP server is completely free and open source. There are no usage limits, API keys, or premium tiers.
The public API at torrentclaw.com is also free with reasonable rate limits.
Yes. TorrentClaw is fully open source (Apache 2.0 license). You can clone the repository, run your own instance, and point the MCP server to your own API by setting the BASE_URL environment variable.
See the GitHub repository for installation instructions.
The public API has reasonable rate limits to prevent abuse. For typical usage (a few searches per minute), you won't hit any limits.
If you need higher limits, consider self-hosting or contact us for custom arrangements.
Common issues:
1. Node.js version: Make sure you have Node.js 18 or higher installed.
2. Restart required: After adding the MCP configuration, you must restart your AI client completely.
3. Logs: Check your client's MCP logs for errors. In Claude Desktop, you can find logs in Developer Tools.
4. Firewall: Make sure your firewall allows outbound connections to torrentclaw.com.
Still Have Questions?
Check out our documentation or reach out on GitHub.