# 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.

> Index of these docs: https://wavegrain.com/developers/llms.txt

**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](/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](/developers/authentication) shows how to make one.

```json
{
  "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`](/developers/mcp-tools/open_upload): Open a drop zone for photos
- [`import_image`](/developers/mcp-tools/import_image): Import an image from a URL
- [`export_slideshow`](/developers/mcp-tools/export_slideshow): Export a slideshow
- [`edit_style`](/developers/mcp-tools/edit_style): Edit a tailored style
- [`copy_style`](/developers/mcp-tools/copy_style): Copy a tailored style
- [`pin_style`](/developers/mcp-tools/pin_style): Pin a style to a brand
- [All 79 tools](/developers/mcp-tools)
