search_assets
Search school assets by free-text query or filters on class, category, or status. Returns up to 50 matches per page with pagination support.
Instructions
Search the school's assets by free-text query and/or filters. Returns up to 50 matches per page. Use the cursor field from the response to fetch the next page.
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": "search_assets"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free-text query (matches name, model, serial). | |
| item_class | No | Filter by class: 'instrument', 'equipment', 'consumable', etc. | |
| category | No | Domain category (e.g. 'brass', 'percussion', 'av'). | |
| status | No | Lifecycle: 'active', 'retired', 'in_repair', etc. | |
| cursor | No | Opaque pagination cursor from a prior response. |
Implementation Reference
- src/tools/index.ts:98-108 (handler)The async handler function that executes the 'search_assets' tool logic. It calls the API endpoint /v1/schools/{schoolId}/gear with optional query parameters (q, item_class, category, status, cursor) and a limit of 50.
async handler(args, client) { const ctx = await client.getContext(); return client.get<unknown>(`/v1/schools/${ctx.schoolId}/gear`, { q: typeof args.q === 'string' ? args.q : undefined, item_class: typeof args.item_class === 'string' ? args.item_class : undefined, category: typeof args.category === 'string' ? args.category : undefined, status: typeof args.status === 'string' ? args.status : undefined, cursor: typeof args.cursor === 'string' ? args.cursor : undefined, limit: '50', }); }, - src/tools/index.ts:78-97 (schema)Input schema for the search_assets tool. Defines the 'q' (free-text query), 'item_class', 'category', 'status', and 'cursor' (pagination) parameters with descriptions.
inputSchema: { type: 'object', properties: { q: { type: 'string', description: 'Free-text query (matches name, model, serial).' }, item_class: { type: 'string', description: "Filter by class: 'instrument', 'equipment', 'consumable', etc.", }, category: { type: 'string', description: "Domain category (e.g. 'brass', 'percussion', 'av').", }, status: { type: 'string', description: "Lifecycle: 'active', 'retired', 'in_repair', etc.", }, cursor: { type: 'string', description: 'Opaque pagination cursor from a prior response.' }, }, additionalProperties: false, }, - src/tools/index.ts:74-109 (registration)Tool definition for 'search_assets' including name, description, input schema, and handler. Exported via the 'tools' array and 'toolByName' map at lines 193-202.
const searchAssets: ToolDef = { name: 'search_assets', description: "Search the school's assets by free-text query and/or filters. Returns up to 50 matches per page. Use the `cursor` field from the response to fetch the next page.", inputSchema: { type: 'object', properties: { q: { type: 'string', description: 'Free-text query (matches name, model, serial).' }, item_class: { type: 'string', description: "Filter by class: 'instrument', 'equipment', 'consumable', etc.", }, category: { type: 'string', description: "Domain category (e.g. 'brass', 'percussion', 'av').", }, status: { type: 'string', description: "Lifecycle: 'active', 'retired', 'in_repair', etc.", }, cursor: { type: 'string', description: 'Opaque pagination cursor from a prior response.' }, }, additionalProperties: false, }, async handler(args, client) { const ctx = await client.getContext(); return client.get<unknown>(`/v1/schools/${ctx.schoolId}/gear`, { q: typeof args.q === 'string' ? args.q : undefined, item_class: typeof args.item_class === 'string' ? args.item_class : undefined, category: typeof args.category === 'string' ? args.category : undefined, status: typeof args.status === 'string' ? args.status : undefined, cursor: typeof args.cursor === 'string' ? args.cursor : undefined, limit: '50', }); }, }; - src/tools/index.ts:193-202 (registration)The tools array and toolByName map that register all tools including search_assets for use by the MCP server.
export const tools: ToolDef[] = [ listSchools, getAsset, searchAssets, getLoansForAsset, listMembers, listAssetThreads, ]; export const toolByName = new Map(tools.map((t) => [t.name, t]));