Skip to main content
Glama
torrentclaw

TorrentClaw-MCP

Official

torrentclaw-mcp

npm version License: MIT CI Node.js

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

Tool

Description

search_content

Search movies/shows with filters (query, type, genre, year, rating, quality, language, audio, HDR, season, episode, sort). Returns torrents, magnet links, and optional streaming info.

autocomplete

Type-ahead search suggestions (up to 8 results). Use to validate titles before a full search.

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

track_interaction

Track user interaction with a torrent (magnet click, download, copy)

submit_scan_request

Submit a torrent for audio/video quality analysis via TrueSpec

get_scan_status

Check the status of a torrent scan request

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"] } } }

Environment Variables

Variable

Default

Description

TORRENTCLAW_API_URL

https://torrentclaw.com

Base 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.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/torrentclaw/torrent-claw-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server