linear_getIssueById

Instructions

Implementation Reference

• src/tools/handlers/issue-handlers.ts:26-39 (handler)

  The main handler function that implements the linear_getIssueById tool logic. It validates the input arguments using the isGetIssueByIdArgs type guard and delegates to LinearService.getIssueById to fetch and return the specific issue.

  export function handleGetIssueById(linearService: LinearService) {
    return async (args: unknown) => {
      try {
        if (!isGetIssueByIdArgs(args)) {
          throw new Error("Invalid arguments for getIssueById");
        }
        
        return await linearService.getIssueById(args.id);
      } catch (error) {
        logError("Error getting issue by ID", error);
        throw error;
      }
    };
  }

• src/tools/definitions/issue-tools.ts:59-106 (schema)

  Defines the MCP tool schema for linear_getIssueById, specifying input (id: string required) and comprehensive output schema for issue details.

  export const getIssueByIdToolDefinition: MCPToolDefinition = {
    name: "linear_getIssueById",
    description: "Get a specific issue by ID or identifier (e.g., ABC-123)",
    input_schema: {
      type: "object",
      properties: {
        id: {
          type: "string",
          description: "The ID or identifier of the issue (e.g., ABC-123)",
        },
      },
      required: ["id"],
    },
    output_schema: {
      type: "object",
      properties: {
        id: { type: "string" },
        identifier: { type: "string" },
        title: { type: "string" },
        description: { type: "string" },
        state: { type: "string" },
        priority: { type: "number" },
        estimate: { type: "number" },
        dueDate: { type: "string" },
        team: { type: "object" },
        assignee: { type: "object" },
        project: { type: "object" },
        cycle: { type: "object" },
        parent: { type: "object" },
        labels: { 
          type: "array",
          items: {
            type: "object",
            properties: {
              id: { type: "string" },
              name: { type: "string" },
              color: { type: "string" }
            }
          }
        },
        sortOrder: { type: "number" },
        createdAt: { type: "string" },
        updatedAt: { type: "string" },
        url: { type: "string" },
        comments: { type: "array" }
      }
    }
  };

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

  Registers the tool name 'linear_getIssueById' to the handleGetIssueById handler function (curried with LinearService instance) within the registerToolHandlers export.

  linear_getIssueById: handleGetIssueById(linearService),

• src/tools/type-guards.ts:15-22 (helper)

  Type guard utility function used by the handler to validate and type-narrow the tool's input arguments to ensure 'id' is a string.

  export function isGetIssueByIdArgs(args: unknown): args is { id: string } {
    return (
      typeof args === "object" &&
      args !== null &&
      "id" in args &&
      typeof (args as { id: string }).id === "string"
    );
  }