list_styles

List tailored styles with Wavegrain's MCP server: the list_styles tool needs the read permission. Inputs, outputs and an example call.

List tailored styles. Permission: read. Read-only: changes nothing.

Example styles and your own tailored styles: id, purpose, canvas, look, niches, sample sheet and whether the brand pinned it.

Inputs

InputTypeRequiredNotes
querystringnoWords to find in a style's name, look or niches. up to 100 characters
purpose"educational" | "list" | "story" | "news" | "product" | "quote"noOnly styles made for this kind of post.
kind"example" | "replicated" | "custom" | "mine"nomine = your own styles of any kind.
canvas"4:5" | "3:4" | "9:16" | "1:1"noOnly styles with this slide shape (width:height).
brandIdstringnoA brand id from list_brands: each style then says whether that brand pinned it. up to 200 characters

The fields inside an object or a list are in the JSON Schema at /developers/mcp-tools.json.

Returns

FieldTypeNotes
stylesobject[]Matching styles, at most 60.
notestringWhat to do next.

Example call

Send it to POST https://wavegrain.com/api/mcp with an access key that has the read permission; Authentication shows how to make one.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_styles",
    "arguments": {}
  }
}

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