C411 MCP Server

C411 MCP Server

An MCP (Model Context Protocol) server for searching torrents on c411.org, fetching torrent metadata and comments, and downloading .torrent files.

Features

• Search torrents on c411.org
• Get detailed torrent metadata by infoHash
• Get paginated torrent comments by infoHash
• Download .torrent files by infoHash
• Reuse authenticated sessions automatically
• Retry expired auth with a small delay and bounded retry count
• Distinguish missing credentials, invalid credentials, and maintenance-mode failures
• Return structured search results with titles, sizes, seed counts, and infoHash when available

Installation

npm install

Usage

Running the server

The server uses stdio transport by default:

npm run dev

Or build and run:

npm run build
npm start

Authentication

C411.org requires authentication to access torrent listings. To enable login:

1. Set the following environment variables:

   • C411_USERNAME: Your c411.org username
   • C411_PASSWORD: Your c411.org password

2. The server will automatically log in and maintain the session.

Without credentials, the server may not be able to retrieve search results.

Auth failure behavior

The server tries to return a more specific error when authentication fails:

• Missing credentials: asks for C411_USERNAME and C411_PASSWORD
• Invalid credentials: reports that the username/password were rejected
• Maintenance mode: reports that c411.org is temporarily unavailable
• Network or timeout issues: returns a sanitized transport error without logging credentials

HTTP requests time out after 10 seconds.

MCP Client Configuration

To use this server with an MCP client (like Claude Desktop), add to your client configuration:

{
  "mcpServers": {
    "c411": {
      "command": "node",
      "args": ["/path/to/c411-mcp-server/build/index.js"],
      "env": {
        "C411_USERNAME": "your_username",
        "C411_PASSWORD": "your_password"
      }
    }
  }
}

For OpenCode, configure the server in your OpenCode config under mcp using a local MCP entry:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "c411": {
      "type": "local",
      "command": ["node", "/path/to/c411-mcp-server/build/index.js"],
      "enabled": true,
      "environment": {
        "C411_USERNAME": "your_username",
        "C411_PASSWORD": "your_password"
      }
    }
  }
}

OpenCode documents MCP servers under the mcp key, with local servers using type: "local", a command array, and environment for env vars.

You can also add it from the OpenCode CLI:

opencode mcp add

Then choose a local MCP server and enter the equivalent values:

• name: c411
• type: local
• command: node /path/to/c411-mcp-server/build/index.js
• environment:
  • C411_USERNAME=your_username
  • C411_PASSWORD=your_password

Afterward, you can verify it was added with:

opencode mcp list

Tools

search_c411

Search for torrents on c411.org.

Parameters:

• query (string, required): Search query, trimmed, 1 to 200 characters
• sortBy (string, optional): Sort criteria. One of relevance, seeders, leechers, size, createdAt, name, completions, comments, category. Defaults to relevance.
• sortOrder (string, optional): Sort order. One of asc, desc. Defaults to desc.
• page (number, optional): Result page number. Defaults to 1.
• perPage (number, optional): Number of results per page. Defaults to 25, maximum 100.

Returns: List of torrent results with titles, sizes, seed counts, and infoHash when available.

get_c411_torrent_info

Get detailed metadata for a torrent on c411.org.

Parameters:

• infoHash (string, required): The 40-character hex infoHash of the torrent

Returns: Structured torrent metadata including title, category, size, seeder and leecher counts, completion count, uploader, creation date, file list, TMDB data when available, and trust information.

get_c411_torrent_comments

Get paginated comments for a torrent on c411.org.

Parameters:

• infoHash (string, required): The 40-character hex infoHash of the torrent
• page (number, optional): Comment page number. Defaults to 1.
• limit (number, optional): Number of comments per page. Defaults to 20, maximum 100.