# get_style

> Get a style with Wavegrain's MCP server: the get_style tool needs the read permission. Inputs, outputs and an example call.

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

**Get a style.** Permission: `read`. Read-only: changes nothing.

One style's layouts, slots and sample sheet, with its spec when you wrote it or the fields you may change when it is Wavegrain's; with brandId, how it takes on that brand.

## Inputs

| Input | Type | Required | Notes |
| --- | --- | --- | --- |
| `styleId` | string | yes | A style id from list_styles. up to 200 characters |
| `version` | integer | no | An older version to read. Default: the current one. 1 to 9007199254740991 |
| `brandId` | string | no | Also show how the style takes on this brand. 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 |
| --- | --- | --- |
| `style` | object | The style. |
| `version` | number | The version read. |
| `note` | string | What changed in this version. |
| `spec` | object | The full spec, for a style you wrote yourself. |
| `editable` | object | Wavegrain's styles: the fields you may change with edit_style (on your copy from copy_style); the rest of the layout stays Wavegrain's. |
| `layouts` | object[] | Each slide layout of the style. |
| `brandFit` | object | How the style takes on the brand given as brandId. |

## 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": "get_style",
    "arguments": {
      "styleId": "<styleId>"
    }
  }
}
```

The call shows only the required inputs, with placeholder values: put your own in.

## Related tools

- [`get_credits`](/developers/mcp-tools/get_credits): Get credits
- [`list_creators`](/developers/mcp-tools/list_creators): List AI creators
- [`list_styles`](/developers/mcp-tools/list_styles): List tailored styles
- [`list_fonts`](/developers/mcp-tools/list_fonts): List fonts
- [`fetch_reference`](/developers/mcp-tools/fetch_reference): Fetch a reference post
- [`search_images`](/developers/mcp-tools/search_images): Search images
- [All 79 tools](/developers/mcp-tools)
