List layouts
list_layoutsSearch or filter the layout catalog to find a specific layout. Returns metadata only, no HTML. Each entry has position (opener/middle/closer: its role in a deck), when_to_use and when_not_to_use: read them to check the layout fits the content before choosing it. Filter by position to fill a slot of the story, e.g. position "closer" for the last slide. Also the tool for "what is new", "any new layouts?", "what got added since last month" - pass since and it returns only what landed after that date. If the user asked for a whole deck rather than one slide, call suggest_deck first instead of this.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_layouts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Language of description, best_for and when_to_use / when_not_to_use. Pass the language the user is writing in. | ko |
| limit | No | Maximum number of layouts to return (1 to 150). Default 30. | |
| query | No | Words that must all appear in the name, description, best_for, when_to_use or content type. | |
| since | No | ISO date (YYYY-MM-DD). Only layouts added after it. Use for "what is new" questions; if the user gave no date, a month back is a sensible default. | |
| category | No | Layout category id to filter by, e.g. a category from the catalog. Omit for all categories. | |
| position | No | The slide's role in a deck: opener = cover, middle = content, closer = ending (summary, CTA, thanks). Use it to fill each part of the story: first slide with opener, last with closer. |