codebeamer-mcp

Instructions

Implementation Reference

• src/tools/items.ts:86-105 (handler)

  Implementation of the 'get_item' MCP tool. It registers the tool and handles the call by invoking the client's getItem method.

  server.registerTool(
    "get_item",
    {
      title: "Get Item",
      description:
        "Get full details of a Codebeamer work item by its numeric ID. " +
        "Returns status, priority, assignees, description, and custom fields.",
      inputSchema: {
        itemId: z
          .number()
          .int()
          .positive()
          .describe("Numeric item (work item) ID"),
      },
    },
    async ({ itemId }) => {
      const item = await client.getItem(itemId);
      return { content: [{ type: "text", text: formatItem(item) }] };
    },
  );