register_source

Inputs

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "kind": {
      "enum": [
        "podcast_rss",
        "youtube_channel",
        "youtube_playlist"
      ]
    },
    "url": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    },
    "display_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "poll_interval_min": {
      "type": "integer",
      "minimum": 15,
      "maximum": 1440,
      "default": 60
    }
  },
  "required": [
    "kind",
    "url"
  ],
  "additionalProperties": false
}

Outputs and behavior

Register a standing source for future metadata detection with capture consent off. Use for the general source workflow; use add_podcast_feed or add_monitored_playlist when you need their feed or playlist IDs. Creates a due detection cursor without an immediate network call; the resident scheduler polls later. Duplicates return the existing source unchanged with created=false. Enable capture separately through set_source_consent after dashboard confirmation.

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": "register_source",
  "arguments": {
    "kind": "podcast_rss",
    "url": "YOUR_URL",
    "poll_interval_min": 60
  }
}

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.