create_style
Create a tailored style with Wavegrain's MCP server: the create_style tool needs the write permission. Inputs, outputs and an example call.
Create a tailored style. Permission: write. Changes saved work.
For power users: save a style spec you wrote as a new private style, with a sample sheet; nothing else changes. To pick a look, use list_styles and copy_style first. Start from get_style's spec. Free.
Inputs
| Input | Type | Required | Notes |
|---|---|---|---|
spec | object | yes | A tailored style spec (layouts, slots, layers, fonts, colours), in the shape get_style answers. |
name | string | no | Overrides spec.name. up to 80 characters |
look | string | no | One line that says what it looks like, for the Style library card. up to 200 characters |
niches | string[] | no | Topics the style suits, such as fitness; list_styles searches them. up to 8 items |
referenceId | string | no | The referenceId from fetch_reference: the post whose layout this style copies. up to 200 characters |
sample | object | yes | Slides Wavegrain makes as the style's sample sheet, to compare with the reference. |
note | string | no | A note on this first version, shown in the version list. up to 300 characters |
The fields inside an object or a list are in the JSON Schema at /developers/mcp-tools.json.
Returns
| Field | Type | Notes |
|---|---|---|
styleId | string | The style id. |
name | string | The style's name. |
version | number | The version this call saved. |
sampleReady | boolean | True when the sample sheet is ready. |
sampleSheetUrl | string | null | An image of sample slides; null when not ready. |
note | string | What to do next. |
slideshowsOnOlderVersions | object[] | Slideshows still on an older version; rerender_with_style_version moves one to the new version. |
Example call
Send it to POST https://wavegrain.com/api/mcp with an access key that has the write permission; Authentication shows how to make one.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "create_style",
"arguments": {
"spec": {},
"sample": {
"slides": [
{
"layout": "<layout>"
}
]
}
}
}
}
The call shows only the required inputs, with placeholder values: put your own in.
Related tools
open_upload: Open a drop zone for photosimport_image: Import an image from a URLexport_slideshow: Export a slideshowedit_style: Edit a tailored stylecopy_style: Copy a tailored stylepin_style: Pin a style to a brand- All 79 tools
Something wrong or missing? Write to support@wavegrain.com.