# create_brand

> Make a brand from a description with Wavegrain's MCP server: the create_brand tool needs the write permission. Inputs, outputs and an example call.

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

**Make a brand from a description.** Permission: `write`. Changes saved work.

Save a new brand from what the user tells you, with only what they said. For a website, use create_brand_from_website. Free.

## Inputs

| Input | Type | Required | Notes |
| --- | --- | --- | --- |
| `name` | string | yes | The brand's name. up to 80 characters |
| `positioning` | string | no | What the brand is and sells, in one or two sentences. up to 500 characters |
| `tone` | string | no | How it sounds, in the user's words. up to 500 characters |
| `audience` | string | no | Who its posts are for. up to 500 characters |
| `angles` | string[] | no | Topics it posts about. up to 10 items |
| `notes` | string | no | Anything else the user said about the brand. up to 2000 characters |
| `avoid` | string[] | no | Topics and words it never uses. up to 20 items |
| `accentColor` | string | no | The main brand colour as a hex code, such as #1A73E8. |
| `secondaryColor` | string | no | The second brand colour. |
| `headingFont` | string | no | The headline font, a family from list_fonts. up to 80 characters |
| `bodyFont` | string | no | A family from list_fonts. up to 80 characters |
| `timeZone` | string | no | The IANA zone it posts in. Default: the zone of the user's other brands. up to 64 characters |
| `postingTimes` | string[] | no | Local HH:MM times it posts at; plan_week uses them. up to 4 items |

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 |
| --- | --- | --- |
| `brandId` | string | The new brand's id. |
| `name` | string | Its name. |
| `timeZone` | string | The IANA zone it posts in. |
| `creditsCharged` | 0 | Making a brand by hand is free. |
| `summary` | string | What was saved, in one line to show the user. |
| `note` | string | What to tell the user. |

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

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

## Related tools

- [`create_account_group`](/developers/mcp-tools/create_account_group): Create an account group
- [`set_account_groups`](/developers/mcp-tools/set_account_groups): Put an account in groups
- [`update_group_settings`](/developers/mcp-tools/update_group_settings): Change group settings
- [`update_brand_settings`](/developers/mcp-tools/update_brand_settings): Change brand settings
- [`propose_brand_change`](/developers/mcp-tools/propose_brand_change): Propose a brand change
- [`propose_group_change`](/developers/mcp-tools/propose_group_change): Propose a group change
- [All 79 tools](/developers/mcp-tools)
