# 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.

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

**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](/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](/developers/authentication) shows how to make one.

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

## Related tools

- [`get_connect_link`](/developers/mcp-tools/get_connect_link): Get a link to connect an account
- [`get_post_status`](/developers/mcp-tools/get_post_status): Get a post's status
- [`get_post_events`](/developers/mcp-tools/get_post_events): Get a post's history
- [`get_playbook`](/developers/mcp-tools/get_playbook): Get the slideshow playbook
- [`estimate_cost`](/developers/mcp-tools/estimate_cost): Estimate credits
- [`get_generation_status`](/developers/mcp-tools/get_generation_status): Get a slideshow's progress
- [All 79 tools](/developers/mcp-tools)
