codebeamer-mcp

Instructions

Implementation Reference

• src/tools/item-details.ts:35-55 (handler)

  The handler and registration for 'get_item_references' which fetches item relations via the client and formats them using 'formatReferences'.

  server.registerTool(
    "get_item_references",
    {
      title: "Get Item References",
      description:
        "Get upstream and downstream traceability references for a Codebeamer item. " +
        "Upstream references point to items this one is derived from (e.g. requirements). " +
        "Downstream references point to items derived from this one (e.g. test cases).",
      inputSchema: {
        itemId: z
          .number()
          .int()
          .positive()
          .describe("Numeric item ID"),
      },
    },
    async ({ itemId }) => {
      const page = await client.getItemRelations(itemId);
      return { content: [{ type: "text", text: formatReferences(page) }] };
    },
  );