# list_styles

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

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

**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

| Input | Type | Required | Notes |
| --- | --- | --- | --- |
| `query` | string | no | Words to find in a style's name, look or niches. up to 100 characters |
| `purpose` | "educational" \| "list" \| "story" \| "news" \| "product" \| "quote" | no | Only styles made for this kind of post. |
| `kind` | "example" \| "replicated" \| "custom" \| "mine" | no | mine = your own styles of any kind. |
| `canvas` | "4:5" \| "3:4" \| "9:16" \| "1:1" | no | Only styles with this slide shape (width:height). |
| `brandId` | string | no | A 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](/developers/mcp-tools.json).

## Returns

| Field | Type | Notes |
| --- | --- | --- |
| `styles` | object[] | Matching styles, at most 60. |
| `note` | string | What to do next. |

## Example call

Send it to `POST https://wavegrain.com/api/mcp` with an access key that has the `read` permission; [Authentication](/developers/authentication) shows how to make one.

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

## Related tools

- [`list_collection_images`](/developers/mcp-tools/list_collection_images): List a collection's images
- [`get_credits`](/developers/mcp-tools/get_credits): Get credits
- [`list_creators`](/developers/mcp-tools/list_creators): List AI creators
- [`get_style`](/developers/mcp-tools/get_style): Get a style
- [`list_fonts`](/developers/mcp-tools/list_fonts): List fonts
- [`fetch_reference`](/developers/mcp-tools/fetch_reference): Fetch a reference post
- [All 79 tools](/developers/mcp-tools)
