suggest_topics
Suggest topics with Wavegrain's MCP server: the suggest_topics tool needs the generate permission. Inputs, outputs and an example call.
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.
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 shows how to make one.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "suggest_topics",
"arguments": {}
}
}
Related tools
create_tailored_slideshow: Make a tailored slideshowremove_background: Cut out a photogenerate_image: Make an AI imagegenerate_slideshow: Make a slideshowcreate_brand_from_website: Make a brand from a websiteresume_automation: Resume an automation- All 79 tools
Something wrong or missing? Write to support@wavegrain.com.