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

InputTypeRequiredNotes
specobjectyesA tailored style spec (layouts, slots, layers, fonts, colours), in the shape get_style answers.
namestringnoOverrides spec.name. up to 80 characters
lookstringnoOne line that says what it looks like, for the Style library card. up to 200 characters
nichesstring[]noTopics the style suits, such as fitness; list_styles searches them. up to 8 items
referenceIdstringnoThe referenceId from fetch_reference: the post whose layout this style copies. up to 200 characters
sampleobjectyesSlides Wavegrain makes as the style's sample sheet, to compare with the reference.
notestringnoA 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

FieldTypeNotes
styleIdstringThe style id.
namestringThe style's name.
versionnumberThe version this call saved.
sampleReadybooleanTrue when the sample sheet is ready.
sampleSheetUrlstring | nullAn image of sample slides; null when not ready.
notestringWhat to do next.
slideshowsOnOlderVersionsobject[]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.

Something wrong or missing? Write to support@wavegrain.com.