Skip to main content
Glama
julien-nc

C411 MCP Server

by julien-nc

C411 MCP Server

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

Table of Contents

Related MCP server: RuTracker MCP Server

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

  • category (string, optional): Category filter. One of 1, 2, 3, 4, 5, 6, 7, 10.

  • subcat (string, optional): Sub-category filter. Only valid when category is 1.

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

list_my_c411_uploads

List torrents uploaded by the current authenticated c411.org user.

Parameters:

  • query (string, optional): Search query, trimmed, 1 to 200 characters.

  • category (string, optional): Category filter. One of 1, 2, 3, 4, 5, 6, 7, 10.

  • subcat (string, optional): Sub-category filter. Only valid when category is 1.

  • 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 100, maximum 100.

Returns: List of torrent results for the current user's uploads, using the same structure as search_c411.

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.

Returns: Structured comment results with pagination metadata and normalized comment entries, including HTML content, plain-text content, author info, timestamps, and reply targets when present.

download_c411_torrent

Download a .torrent file from c411.org and save it to disk.

Parameters:

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

  • outputDir (string, optional): Directory where the .torrent file should be saved. Defaults to /tmp.

Returns: The full path of the saved .torrent file.

Example:

infoHash: "178a3516f248e45f9857abbc2cbc8a8b20f29815"
outputDir: "/tmp"

Project structure

  • src/index.ts: bootstrap only; creates the MCP server and starts stdio

  • src/c411-client.ts: c411 auth, retries, search, torrent info, comments, and download logic

  • src/register-tools.ts: MCP tool registration

  • src/formatters.ts: formatting and normalization helpers for search, torrent info, and comments

  • src/http-response-utils.ts: response parsing and maintenance detection helpers

  • src/http-client.ts: isolated Axios + cookie-jar setup

  • src/schemas.ts: Zod tool schemas

  • src/types.ts: shared TypeScript types

Development

  • npm run dev: Run in development mode with hot reload

  • npm run build: Compile TypeScript to JavaScript

  • npm start: Run the compiled server

Notes

  • This server is for personal use only

  • Respect c411.org's terms of service

  • Keep your credentials secure

  • The scraper may need updates if the website structure changes

Available Tools

4 tools
download_c411_torrentA

Download a .torrent file from c411.org by its infoHash and save it to disk.

ParametersJSON Schema
NameRequiredDescriptionDefault
infoHashYesThe 40-character hex infoHash of the torrent
outputDirNoDirectory where the .torrent file should be saved. Defaults to /tmp.

Output Schema

ParametersJSON Schema
NameRequiredDescription
errorNo
successYes
filenameNo
savedPathNo

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full disclosure burden. Successfully discloses the side effect ('save to disk'), indicating filesystem mutation. However, lacks details on idempotency, network requirements, error handling (e.g., invalid hash), or output structure despite having an output schema available.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single, dense sentence with zero waste. Front-loaded with the action verb, immediately communicating purpose. Every clause earns its place: source domain, identification method, and persistence mechanism are all efficiently packed.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Appropriate for a 2-parameter tool with full schema coverage and existing output schema. Covers the essential 'what' and 'where to' aspects. Minor gap: could briefly mention the return value indicates success/failure or file path since annotations are absent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, establishing a baseline of 3. Description adds value by clarifying the infoHash's role in identifying the specific torrent to retrieve ('by its infoHash'), and implicitly connects the outputDir to the 'save to disk' action. Could mention the default /tmp behavior explicitly, but overall adds meaningful usage context.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Excellent specificity: states the verb ('Download'), resource ('.torrent file'), source ('c411.org'), identifier ('by its infoHash'), and side effect ('save to disk'). Clearly distinguishes from siblings 'get_c411_torrent_info' and 'search_c411' through the explicit action of downloading vs retrieving metadata or searching.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides implied usage context through the specific action ('download... save to disk'), but lacks explicit when-to-use guidance contrasting with siblings. Does not state prerequisites (e.g., valid c411.org infoHash) or error conditions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_c411_torrent_commentsA

Get comments for a c411.org torrent by its infoHash.

ParametersJSON Schema
NameRequiredDescriptionDefault
infoHashYesThe 40-character hex infoHash of the torrent
pageNoComment page number. Defaults to 1.
limitNoNumber of comments per page. Defaults to 20.

Output Schema

ParametersJSON Schema
NameRequiredDescription
pageYes
errorNo
limitYes
totalNo
commentsYes
infoHashYes
totalPagesNo
resultCountYes

TDQS

A3.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, yet description fails to disclose behavioral traits: no mention of pagination behavior (despite page/limit params), rate limits, authentication requirements for c411.org, or handling of empty comment sets. 'Get' implies read-only but does not confirm it.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single efficient sentence of 9 words. Front-loaded with verb, zero redundancy, every token carries meaning (domain, resource, identifier).

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Adequate for a read operation given 100% schema coverage and existence of output schema (which handles return value documentation). Could be improved by mentioning pagination or empty state handling, but functional for tool selection.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, establishing baseline 3. Description adds minimal semantics beyond schema—only linking infoHash to the retrieval operation via 'by its infoHash'. Schema already documents the 40-character hex pattern and pagination defaults.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Specific verb 'Get' + resource 'comments for a c411.org torrent' clearly identifies the operation. Explicitly distinguishes from siblings: targets comments (not download, info metadata, or search index) and specifies the external domain.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides clear context by identifying the specific resource (comments) and required identifier (infoHash), implicitly distinguishing from sibling torrent operations. However, lacks explicit workflow guidance (e.g., 'use after search_c411 to retrieve infoHash').

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_c411_torrent_infoA

Get detailed metadata for a c411.org torrent by its infoHash.

ParametersJSON Schema
NameRequiredDescriptionDefault
infoHashYesThe 40-character hex infoHash of the torrent

Output Schema

ParametersJSON Schema
NameRequiredDescription
sizeNo
tmdbNo
errorNo
filesNo
titleNo
trustNo
statusNo
seedersNo
successNo
categoryNo
infoHashYes
leechersNo
uploaderNo
createdAtNo
fileCountNo
sizeBytesNo
completionsNo
isExclusiveNo
isFreeleechNo
subcategoryNo
descriptionHtmlNo
lowBitrateWarningNo

TDQS

A3.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full disclosure burden but only states it's a read operation ('Get') targeting metadata. It fails to disclose what 'detailed metadata' specifically includes, error conditions for invalid hashes, rate limits, or caching behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence of 10 words with zero waste. Front-loaded with action verb 'Get', immediately identifies the resource (c411.org torrent metadata), and specifies the lookup key (infoHash). Every word earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Appropriate for a simple 1-parameter tool with output schema present (no need to describe return values). Sufficient for invocation but could be improved by explicitly mentioning the sibling workflow (obtain hash via search_c411 first).

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with the infoHash parameter fully documented including pattern validation. The description mentions 'by its infoHash' but adds no semantic meaning beyond the schema's existing '40-character hex infoHash' description, meeting the baseline for high-coverage schemas.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses specific verb 'Get' with clear resource 'detailed metadata for a c411.org torrent' and scope identifier 'by its infoHash'. This clearly distinguishes from sibling download_c411_torrent (content vs metadata), get_c411_torrent_comments (metadata vs comments), and search_c411 (specific hash lookup vs broad search).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The phrase 'by its infoHash' implicitly signals you must already possess the hash to use this tool, distinguishing it from search_c411. However, it lacks explicit guidance on the prerequisite workflow (search first, then this tool) or when to prefer alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_c411B

Search for torrents on c411.org

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYesSearch query for torrents
sortByNoSort criteria for the search results. Defaults to relevance.relevance
sortOrderNoSort order for the search results. Defaults to desc.desc
pageNoResult page number. Defaults to 1.
perPageNoNumber of results per page. Defaults to 25.

Output Schema

ParametersJSON Schema
NameRequiredDescription
pageYes
errorNo
queryYes
totalNo
perPageYes
resultsYes
totalPagesNo
resultCountYes

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden for behavioral disclosure. It states nothing about network requirements, rate limits, authentication, idempotency, or whether results are cached. The minimal description offers no behavioral context beyond the basic action.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The single sentence 'Search for torrents on c411.org' is appropriately sized with zero redundancy. It is front-loaded with the action and contains no filler text, making it efficiently scannable.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the 100% parameter schema coverage and presence of an output schema, the description does not need to elaborate on return values or parameter details. However, it lacks mention of the typical workflow (search → download/info) that would complete the context for an agent selecting among the four related tools.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 100% schema description coverage, the input schema fully documents all 5 parameters (query, sortBy, sortOrder, page, perPage). The description adds no additional semantic information beyond what the schema provides, which warrants the baseline score for high-coverage schemas.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb ('Search') and resource ('torrents on c411.org'), clearly identifying the tool's function. However, it does not explicitly differentiate from siblings like 'get_c411_torrent_info' (which retrieves specific torrent details by ID rather than searching).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It fails to mention that search results are typically prerequisite for using sibling tools like 'download_c411_torrent' or 'get_c411_torrent_info', or that this is the entry point for discovery.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 4 tool updatesv1.0.0
    • First observeddownload_c411_torrent
    • First observedget_c411_torrent_comments
    • First observedget_c411_torrent_info
    • First observedsearch_c411

TDQS

A3.8/5.0
Disambiguation5/5

Each tool has a clearly distinct purpose: downloading torrent files, retrieving comments, getting metadata, and searching. The descriptions specify unique actions on the same domain (c411.org torrents), with no overlap that would cause misselection.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern with 'c411' as a prefix (e.g., download_c411_torrent, search_c411). The naming is uniform, using snake_case throughout and clear action descriptors.

Tool Count5/5

With 4 tools, the server is well-scoped for interacting with a torrent search site. Each tool serves a distinct function (search, info, comments, download), making the count appropriate and efficient for the domain.

Completeness4/5

The toolset covers core operations for torrent discovery and retrieval (search, get info, get comments, download), with no obvious dead ends. A minor gap might be the lack of upload or management tools, but for a client-focused server, this is reasonable.

Maintenance

ActivityInactive
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • F
    license
    A
    quality
    D
    maintenance
    Enables interaction with qBittorrent through its Web API to search for torrents using search plugins and manage downloads. Supports torrent searching, downloading via URLs/magnet links, and torrent management operations like pause, resume, and delete.
    7
    3
    -
  • F
    license
    Not graded
    quality
    B
    maintenance
    Allows users to search and browse torrents on rutracker.org, retrieving detailed metadata including magnet links and file lists. It automatically handles authentication by extracting session cookies from the Brave browser on macOS.
    -
  • A
    license
    A
    quality
    C
    maintenance
    Enables AI assistants to interact with the M-Team private torrent tracker API for searching resources, retrieving torrent details, and downloading torrent files. It provides a bridge for Model Context Protocol clients to manage and access private tracker content through natural language.
    3
    10
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables searching and downloading torrents from iptorrents.com using browser cookie-based authentication, with features like filtering, sorting, and freeleech detection.
    -

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/julien-nc/mcp-server-c411'

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