linear_getWorkflowStates

Instructions

Implementation Reference

• src/tools/handlers/team-handlers.ts:19-37 (handler)

  Handler function that implements the core logic of the linear_getWorkflowStates tool. Validates arguments using type guard and delegates to LinearService.getWorkflowStates.

  /**
   * Handler for getting workflow states for a team
   */
  export function handleGetWorkflowStates(linearService: LinearService) {
    return async (args: unknown) => {
      try {
        if (!isGetWorkflowStatesArgs(args)) {
          throw new Error("Invalid arguments for getWorkflowStates");
        }
        
        return await linearService.getWorkflowStates(
          args.teamId, 
          args.includeArchived || false
        );
      } catch (error) {
        logError("Error getting workflow states", error);
        throw error;
      }
    };

• src/tools/definitions/team-tools.ts:39-71 (schema)

  MCP tool definition specifying name, description, input_schema (teamId required, includeArchived optional boolean), and output_schema for workflow state objects.

   */
  export const getWorkflowStatesToolDefinition: MCPToolDefinition = {
    name: "linear_getWorkflowStates",
    description: "Get workflow states for a team",
    input_schema: {
      type: "object",
      properties: {
        teamId: {
          type: "string",
          description: "ID of the team to get workflow states for",
        },
        includeArchived: {
          type: "boolean",
          description: "Whether to include archived states (default: false)",
        },
      },
      required: ["teamId"],
    },
    output_schema: {
      type: "array",
      items: {
        type: "object",
        properties: {
          id: { type: "string" },
          name: { type: "string" },
          type: { type: "string" },
          position: { type: "number" },
          color: { type: "string" },
          description: { type: "string" }
        }
      }
    }
  }; 

• src/tools/handlers/index.ts:60-61 (registration)

  Registration of the linear_getWorkflowStates handler within the registerToolHandlers function's return object.

  linear_getTeams: handleGetTeams(linearService),
  linear_getWorkflowStates: handleGetWorkflowStates(linearService),

• src/tools/type-guards.ts:513-536 (helper)

  Type guard helper function used by the handler to validate input arguments for teamId (string, required) and includeArchived (boolean, optional).

   * Type guard for linear_getWorkflowStates tool arguments
   */
  export function isGetWorkflowStatesArgs(args: unknown): args is {
    teamId: string;
    includeArchived?: boolean;
  } {
    if (
      typeof args !== "object" ||
      args === null ||
      !("teamId" in args) ||
      typeof (args as { teamId: string }).teamId !== "string"
    ) {
      return false;
    }
  
    if (
      "includeArchived" in args &&
      typeof (args as { includeArchived: boolean }).includeArchived !== "boolean"
    ) {
      return false;
    }
  
    return true;
  } 

• src/tools/definitions/index.ts:54-56 (registration)

  Inclusion of the linear_getWorkflowStates tool definition in the allToolDefinitions array for overall tool registration.

  // Team tools
  getTeamsToolDefinition,
  getWorkflowStatesToolDefinition,