List the formats library

Hook structures (formula with [slots], category, why it works, platforms), presentation formats (kind body: style such as tier_list or screen_share, ordered beats, presentation) and proven combos (kind combo: a huge outlier's hook structure + presentation format pair, with its usage), each with its source outlier (creator, views, outlier score, date, drivenBy hook|format|both), the niche's evidence (outliers this month, median, driven-by counts) and a rank by recency × performance × trend with this person's own results. Also returns per-style trends, the huge-outlier threshold and archived outlier ideas. An idea is one atomic article from the person’s own material, recorded as 2–3 hook structures × 2 presentation formats (tier_list, talking_head, screen_share, green_screen, listicle, myth_vs_fact, before_after, whiteboard, story, hot_take, split_screen, podcast_clip) × one call to action per push. Formats lend structure only: never carry another creator’s topic, claims or wording into a hook formula ([slots] hold the topic) or a format’s beats. Calls to action come from pushes: one per active push that serves the article’s funnel step, and a push that delivers something must lead to a live free asset with a link or an active offer.

formats_listOtherRead only

Behavior

Read-only hint
True
Destructive hint
Not declared
Idempotent hint
Not declared
Open-world hint
Not declared

Parameters

NameTypeRequirementDescription
workspaceIdstringRequiredThe workspace id or slug (from workspace_list).
kindstringOptionalNo additional description.
stylestringOptionalNo additional description.
statusstringOptionalNo additional description.
limitintegerOptionalNo additional description.

Input JSON Schema

Generated from the registered input schema
{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "minLength": 1,
      "description": "The workspace id or slug (from workspace_list)."
    },
    "kind": {
      "type": "string",
      "enum": [
        "hook",
        "body",
        "combo"
      ]
    },
    "style": {
      "type": "string",
      "enum": [
        "tier_list",
        "talking_head",
        "screen_share",
        "green_screen",
        "listicle",
        "myth_vs_fact",
        "before_after",
        "whiteboard",
        "story",
        "hot_take",
        "split_screen",
        "podcast_clip",
        "carousel",
        "other"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "proposed",
        "archived"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "workspaceId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Call shape

Use an MCP client rather than sending this JSON directly. The client handles protocol negotiation, sessions, and authentication.

Protocol request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "formats_list",
    "arguments": {}
  }
}