discover_candidates

Inputs

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "creator",
        "keyword"
      ]
    },
    "platform": {
      "type": "string",
      "enum": [
        "tiktok",
        "instagram",
        "youtube",
        "youtube_shorts"
      ]
    },
    "handle": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "channel_id": {
      "type": "string",
      "pattern": "^UC[A-Za-z0-9_-]{22}$"
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "pages": {
      "type": "integer",
      "minimum": 1,
      "maximum": 3,
      "default": 1
    },
    "confirm_credits": {
      "type": "integer"
    },
    "user_intent_token": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    }
  },
  "additionalProperties": false,
  "required": [
    "mode",
    "platform"
  ]
}

Outputs and behavior

Plan or run a ScrapeCreators search and save uncaptured candidates. Use to find new material; use search_library for saved evidence and queue_discovered to capture selected candidates. Off by default; requires a saved key, discovery enabled and daily credit room. Omit confirm_credits for a free plan, then confirm its exact cost. Spending requires agent discovery consent or a dashboard intent; stdio needs agent consent because dashboard intents are process-bound. No candidate is captured by this call.

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": "discover_candidates",
  "arguments": {
    "mode": "creator",
    "platform": "tiktok",
    "pages": 1
  }
}

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.