search_inspiration

Search the Inspiration library with Wavegrain's MCP server: the search_inspiration tool needs the read permission. Inputs, outputs and an example call.

Search the Inspiration library. Permission: read. Read-only: changes nothing.

Find proven slideshow posts in the Inspiration library by topic, niche or the brand's words, with hooks, views and saves. Open one with fetch_reference. Free.

Inputs

InputTypeRequiredNotes
querystringnoTopic words. Leave out to search by the brand's own positioning. up to 200 characters
nichestringnoA topic area, such as fitness, from the niches this tool answers. up to 60 characters
brandIdstringnoWhose words to search by when there is no query. Default: your active brand. up to 200 characters
limitintegernoHow many posts to return. 1 to 20, default 10

The fields inside an object or a list are in the JSON Schema at /developers/mcp-tools.json.

Returns

FieldTypeNotes
searchedForstringThe search as Wavegrain read it.
postsobject[]Matching high-performing posts.
nichesstring[]Every niche you can pass as niche.
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 read permission; Authentication shows how to make one.

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

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