import_list

Inputs

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "HackerTube, Hacker News thread, Reddit thread or YouTube playlist URL."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 50,
      "description": "Videos per batch (1-50)."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "default": 0,
      "description": "Start position in the list."
    },
    "preview_only": {
      "type": "boolean",
      "default": false,
      "description": "Count without queueing."
    }
  },
  "additionalProperties": false,
  "required": [
    "url"
  ]
}

Outputs and behavior

Queue every video from a list source for normal capture: a HackerTube playlist, category, area or the whole collection best first (hackertube.org, ODC-By 1.0), a Hacker News thread, a Reddit thread, or a YouTube playlist. Use for many videos picked by someone else; use uoink_playlist to capture a playlist as one tracked job or uoink_video for one video. Reads one batch of at most 50 (offset pages through big lists), skips videos already in the library, and queues the rest on the background download queue one at a time. Set preview_only to count without queueing. Returns found, already, queued, next_offset and per-video rows; imported items keep their source tag and note.

The registry does not publish an output schema for this tool. The description above is its documented behavior; response fields beyond it are not specified here.

Example call

Example tool name and arguments, generated from the input schema. Replace placeholder strings and sample numbers with your own values. This is a request template, not a recorded call or response.

{
  "name": "import_list",
  "arguments": {
    "url": "YOUR_URL",
    "limit": 50,
    "offset": 0,
    "preview_only": false
  }
}

Clients

This tool is available to MCP clients using stdio or http.

The registry records transport support, not individual client test results. See the MCP setup reference for named clients, configuration, and tool-list limits.