get-issue-root-causes
Retrieve root cause categories and causes to assign to issues in Autodesk Construction Cloud projects. Use this tool to analyze and document issue origins for better project management.
Instructions
Retrieves a list of supported root cause categories and root causes that you can allocate to an issue in Autodesk Construction Cloud.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| projectId | Yes |
Implementation Reference
- src/tools/get-issue-root-causes.ts:14-26 (handler)The asynchronous callback function that executes the core logic of the 'get-issue-root-causes' tool. It authenticates via access token, strips 'b.' prefix from projectId, fetches root cause categories using IssuesClient, and returns formatted results.
callback: async ({ projectId }) => { // TODO: add pagination support const accessToken = await getAccessToken(["data:read"]); const issuesClient = new IssuesClient(); projectId = projectId.replace("b.", ""); // the projectId should not contain the "b." prefix const rootCauses = await issuesClient.getRootCauseCategories(projectId, { accessToken }); if (!rootCauses.results) { throw new Error("No root causes found"); } return { content: rootCauses.results.map((rootCause) => ({ type: "text", text: JSON.stringify(rootCause) })) }; } - Zod schema defining the input parameter 'projectId' as a non-empty string.
const schema = { projectId: z.string().nonempty() }; - src/server.ts:12-14 (registration)Dynamic registration loop that registers the 'get-issue-root-causes' tool (imported via tools/index.js) by calling server.tool() with its title, description, schema, and callback.
for (const tool of Object.values(tools)) { server.tool(tool.title, tool.description, tool.schema, tool.callback); }