get_cycle
Retrieve detailed information about a specific cycle within a Plane MCP Server project using its unique project and cycle identifiers. Ideal for managing and tracking project cycles efficiently.
Instructions
Get details of a specific cycle
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cycle_id | Yes | The uuid identifier of the cycle to get | |
| project_id | Yes | The uuid identifier of the project containing the cycle |
Implementation Reference
- src/tools/cycles.ts:37-50 (handler)Handler function that fetches the details of a specific cycle by making a GET request to the Plane API endpoint and returns the JSON response formatted as text content.async ({ project_id, cycle_id }) => { const response = await makePlaneRequest( "GET", `workspaces/${process.env.PLANE_WORKSPACE_SLUG}/projects/${project_id}/cycles/${cycle_id}/` ); return { content: [ { type: "text", text: JSON.stringify(response, null, 2), }, ], }; }
- src/tools/cycles.ts:33-36 (schema)Zod input schema defining the required parameters: project_id and cycle_id for the get_cycle tool.{ project_id: z.string().describe("The uuid identifier of the project containing the cycle"), cycle_id: z.string().describe("The uuid identifier of the cycle to get"), },
- src/tools/cycles.ts:30-51 (registration)Direct registration of the get_cycle tool on the MCP server, specifying name, description, input schema, and handler function.server.tool( "get_cycle", "Get details of a specific cycle", { project_id: z.string().describe("The uuid identifier of the project containing the cycle"), cycle_id: z.string().describe("The uuid identifier of the cycle to get"), }, async ({ project_id, cycle_id }) => { const response = await makePlaneRequest( "GET", `workspaces/${process.env.PLANE_WORKSPACE_SLUG}/projects/${project_id}/cycles/${cycle_id}/` ); return { content: [ { type: "text", text: JSON.stringify(response, null, 2), }, ], }; } );
- src/tools/index.ts:21-21 (registration)Invocation of registerCycleTools within the top-level tools registration, which includes the get_cycle tool.registerCycleTools(server);