Search vault items
vault_search_itemsSearch the item library the user has access to (stock items plus their own house items). Use this to locate an item by name, type (the catalog's own item types), or ruleset. Defaults to a compact summary shape (identification + summary + weight + cost + publisher / source); pass detail: 'full' to receive each item's full description and properties array inline.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "vault_search_items"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Matches the item's name or any other name it is known by (a stock item with a generic name also answers to its rulebook name), ignoring case, apostrophe style, spaces, and hyphens. Results show the stock name. Use `^name$` for an exact match. | |
| skip | No | Pagination offset; pair with `limit` to walk results. | |
| sort | No | Comma-separated field list. Prefix with `-` for descending (e.g. `-updatedAt,name`). | |
| type | No | Item type (substring, case-insensitive). Vault item types are ruleset-specific strings; an unfiltered search shows the types a ruleset's catalog uses. | |
| limit | No | Page size; defaults to 50 when omitted. Hard cap of 200. | |
| stock | No | true = official content only; false = user-authored only; omit to include both. | |
| detail | No | Response shape. 'summary' (default) returns identification + summary fields; 'full' returns the complete document shape (every field inline) that non-MCP clients receive by default. | summary |
| ruleset | No | Ruleset code, from list_rulesets. | |
| character | No | Mongo `_id` of the vault Character you are picking content for (adding to its sheet, building or levelling it). Pass it whenever the results are offered for a particular Character: the stock records its Worlds hide are left out, as in the app's own pickers. An id that names no Character the user can see is ignored. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| results | No | ||
| pagination | No |