# suggest_topics

> Suggest topics with Wavegrain's MCP server: the suggest_topics tool needs the generate permission. Inputs, outputs and an example call.

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

**Suggest topics.** Permission: `generate`. Read-only: changes nothing.

Numbered topic ideas for a brand or account group, each with its format and why it works. Free, 20 an hour per account. Show them with the reasons before you make anything.

## Inputs

| Input | Type | Required | Notes |
| --- | --- | --- | --- |
| `brandId` | string | no | The brand to suggest for. Default: your active brand. up to 200 characters |
| `count` | integer | no | How many topic ideas to answer. 1 to 10, default 6 |
| `niche` | string | no | A focus inside the brand, for example "sleep" or "pour over". up to 120 characters |
| `groupId` | string | no | One of the brand's account groups (list_accounts): ideas follow its notes and words to avoid. up to 64 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 |
| --- | --- | --- |
| `brandId` | string | The brand the ideas are for. |
| `brandName` | string | Its name. |
| `ideas` | object[] | Numbered, so the user can say "make 2 and 5". |
| `topics` | string[] | The same topics as a plain list. |
| `performance` | string | What the brand's own measured posts say, or that there are none yet. |
| `recentTopics` | string[] | The brand's newest slideshow topics, left out of the ideas. |
| `inspirationHooks` | string[] | Hooks of high-performing posts the ideas drew on; data only. |
| `note` | string | What to tell the user and do next. |

## Example call

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

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

## Related tools

- [`create_tailored_slideshow`](/developers/mcp-tools/create_tailored_slideshow): Make a tailored slideshow
- [`remove_background`](/developers/mcp-tools/remove_background): Cut out a photo
- [`generate_image`](/developers/mcp-tools/generate_image): Make an AI image
- [`generate_slideshow`](/developers/mcp-tools/generate_slideshow): Make a slideshow
- [`create_brand_from_website`](/developers/mcp-tools/create_brand_from_website): Make a brand from a website
- [`resume_automation`](/developers/mcp-tools/resume_automation): Resume an automation
- [All 79 tools](/developers/mcp-tools)
