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
| Input | Type | Required | Notes |
|---|---|---|---|
query | string | no | Topic words. Leave out to search by the brand's own positioning. up to 200 characters |
niche | string | no | A topic area, such as fitness, from the niches this tool answers. up to 60 characters |
brandId | string | no | Whose words to search by when there is no query. Default: your active brand. up to 200 characters |
limit | integer | no | How 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
| Field | Type | Notes |
|---|---|---|
searchedFor | string | The search as Wavegrain read it. |
posts | object[] | Matching high-performing posts. |
niches | string[] | Every niche you can pass as niche. |
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 read permission; Authentication shows how to make one.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_inspiration",
"arguments": {}
}
}
Related tools
get_connect_link: Get a link to connect an accountget_post_status: Get a post's statusget_post_events: Get a post's historyget_playbook: Get the slideshow playbookestimate_cost: Estimate creditsget_generation_status: Get a slideshow's progress- All 79 tools
Something wrong or missing? Write to support@wavegrain.com.