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.
Behavior
- Read-only hint
- True
- Destructive hint
- Not declared
- Idempotent hint
- Not declared
- Open-world hint
- Not declared
Parameters
| Name | Type | Requirement | Description |
|---|---|---|---|
workspaceId | string | Required | The workspace id or slug (from workspace_list). |
kind | string | Optional | No additional description. |
style | string | Optional | No additional description. |
status | string | Optional | No additional description. |
limit | integer | Optional | No additional description. |
Input JSON 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.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "formats_list",
"arguments": {}
}
}