List Tracker Items
list_tracker_itemsRetrieve a paginated list of items from a Codebeamer tracker, including IDs, summaries, statuses, and priorities.
Instructions
List all items in a specific Codebeamer tracker with pagination. Returns a table with item IDs, summaries, statuses, and priorities.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| trackerId | Yes | Numeric tracker ID | |
| page | No | Page number (starts at 1) | |
| pageSize | No | Items per page (max 50) |
Implementation Reference
- src/tools/items.ts:48-84 (registration)The tool registration using server.registerTool() with the name 'list_tracker_items', input schema, and handler callback.
server.registerTool( "list_tracker_items", { title: "List Tracker Items", description: "List all items in a specific Codebeamer tracker with pagination. " + "Returns a table with item IDs, summaries, statuses, and priorities.", inputSchema: { trackerId: z .number() .int() .positive() .describe("Numeric tracker ID"), page: z .number() .int() .min(1) .default(1) .describe("Page number (starts at 1)"), pageSize: z .number() .int() .min(1) .max(50) .default(25) .describe("Items per page (max 50)"), }, }, async ({ trackerId, page, pageSize }) => { const { items, debug } = await client.listTrackerItems(trackerId, page, pageSize); let text = formatItemList(items); if (items.length === 0 && debug) { text += `\n\n---\n**Debug (raw API responses):**\n\`\`\`\n${debug}\n\`\`\``; } return { content: [{ type: "text", text }] }; }, ); - src/tools/items.ts:55-74 (schema)Input schema for list_tracker_items: trackerId (positive int), page (min 1, default 1), pageSize (min 1, max 50, default 25). All defined using Zod.
inputSchema: { trackerId: z .number() .int() .positive() .describe("Numeric tracker ID"), page: z .number() .int() .min(1) .default(1) .describe("Page number (starts at 1)"), pageSize: z .number() .int() .min(1) .max(50) .default(25) .describe("Items per page (max 50)"), },