list_niches

List every catalogued YouTube niche for the active research run. Use the returned slugs as the niche argument to research_content_gaps.

MCP list_niches 1 credit REST equivalent: GET /v1/research/niches

REST vs MCP response shape

MCP tool responses include two extra fields that the REST endpoint does not return:

score_id — an immutable identifier for the call, useful for client-side correlation and replay.
credits_remaining — your balance after this call. REST clients fetch the balance via GET /v1/usage/.

benchmark_channel and benchmark_video additionally wrap the response body under a payload field, so the envelope is {score_id, credits_remaining, payload}. The other tools merge the fields at the top level.

This is intentional. Tool-using agents typically want both pieces of state inline; HTTP clients usually do not.

Parameters

None. Call the tool with no arguments.

Example response

{
  "score_id": "01J7K9...",
  "niches": [
    {
      "slug": "tech-tutorials",
      "name": "Tech Tutorials",
      "gap_count": 42
    },
    {
      "slug": "tech-reviews",
      "name": "Tech Reviews",
      "gap_count": 31
    },
    {
      "slug": "ai-news",
      "name": "AI News",
      "gap_count": 18
    }
  ],
  "credits_remaining": 348
}

Client setup

See Client setup for Claude Desktop and Cursor configuration. Once configured, ask your client to call list_niches.