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

InputTypeRequiredNotes
brandIdstringnoThe brand to suggest for. Default: your active brand. up to 200 characters
countintegernoHow many topic ideas to answer. 1 to 10, default 6
nichestringnoA focus inside the brand, for example "sleep" or "pour over". up to 120 characters
groupIdstringnoOne 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

FieldTypeNotes
brandIdstringThe brand the ideas are for.
brandNamestringIts name.
ideasobject[]Numbered, so the user can say "make 2 and 5".
topicsstring[]The same topics as a plain list.
performancestringWhat the brand's own measured posts say, or that there are none yet.
recentTopicsstring[]The brand's newest slideshow topics, left out of the ideas.
inspirationHooksstring[]Hooks of high-performing posts the ideas drew on; data only.
notestringWhat 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": {}
  }
}

Something wrong or missing? Write to support@wavegrain.com.