jira_get_issue
Retrieve detailed information about a specific JIRA issue by providing its issue key to access ticket details directly within your development environment.
Instructions
Retrieves detailed information about a specific JIRA issue
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| issueKey | Yes |
Implementation Reference
- GetIssueHandler class that implements the core tool logic: validates input parameters, executes the GetIssueUseCase to fetch issue data from JIRA, formats the response with IssueFormatter, and provides detailed error handling with user-friendly messages.export class GetIssueHandler extends BaseToolHandler<GetIssueParams, string> { private formatter: IssueFormatter; /** * Create a new GetIssueHandler with use case and validator * * @param getIssueUseCase - Use case for retrieving issue details * @param issueParamsValidator - Validator for issue parameters */ constructor( private readonly getIssueUseCase: GetIssueUseCase, private readonly issueParamsValidator: IssueParamsValidator, ) { super("JIRA", "Get Issue"); this.formatter = new IssueFormatter(); } /** * Execute the handler logic * Retrieves issue details and formats them using the formatter * * @param params - Parameters for issue retrieval */ protected async execute(params: GetIssueParams): Promise<string> { try { // Step 1: Validate parameters const validatedParams = this.issueParamsValidator.validateGetIssueParams(params); this.logger.info(`Getting JIRA issue: ${validatedParams.issueKey}`); // Step 2: Get issue using use case const issue = await this.getIssueUseCase.execute(validatedParams); // Step 3: Format issue using the formatter return this.formatter.format(issue); } catch (error) { this.logger.error(`Failed to get issue: ${error}`); throw this.enhanceError(error, params); } } /** * Enhance error messages for better user guidance */ private enhanceError(error: unknown, params?: GetIssueParams): Error { const issueContext = params?.issueKey ? ` for issue ${params.issueKey}` : ""; if (error instanceof JiraNotFoundError) { return new Error( `❌ **Issue Not Found**\n\nNo issue found${issueContext}.\n\n**Solutions:**\n- Verify the issue key is correct\n- Check if the issue exists\n- Verify you have permission to view the issue\n\n**Example:** \`jira_get_issue issueKey="PROJ-123"\``, ); } if (error instanceof JiraPermissionError) { return new Error( `❌ **Permission Denied**\n\nYou don't have permission to view the issue${issueContext}.\n\n**Solutions:**\n- Check your JIRA permissions\n- Contact your JIRA administrator\n- Verify you have access to the project\n\n**Required Permissions:** Browse Projects`, ); } if (error instanceof JiraApiError) { return new Error( `❌ **JIRA API Error**\n\n${error.message}\n\n**Solutions:**\n- Verify the issue key is valid (format: PROJ-123)\n- Check your JIRA connection\n- Try with a different issue\n\n**Example:** \`jira_get_issue issueKey="PROJ-123"\``, ); } if (error instanceof Error) { return new Error( `❌ **Issue Retrieval Failed**\n\n${error.message}${issueContext}\n\n**Solutions:**\n- Check your parameters are valid\n- Verify your JIRA connection\n- Try with a different issue\n\n**Example:** \`jira_get_issue issueKey="PROJ-123"\``, ); } return new Error( `❌ **Unknown Error**\n\nAn unknown error occurred during issue retrieval${issueContext}.\n\nPlease check your parameters and try again.`, ); }
- Zod schema definitions for tool input parameters: issueKeySchema (required, regex /^[A-Z]+-\d+$/) and getIssueParamsSchema (includes optional fields). The tool config uses { issueKey: issueKeyRegex }.export const getIssueParamsSchema = z.object({ issueKey: issueKeySchema, fields: z.array(z.string()).optional(), });
- src/features/jira/tools/configs/issue-tools.config.ts:30-35 (registration)Tool configuration object defining the 'jira_get_issue' tool: name, description, input params schema (issueKey), and handler function binding. Used by registry to register with MCP server.{ name: "jira_get_issue", description: "Retrieves detailed information about a specific JIRA issue", params: { issueKey: issueKeySchema }, handler: tools.jira_get_issue.handle.bind(tools.jira_get_issue), },
- Tool factory creating the jira_get_issue handler wrapper that delegates calls to the instantiated GetIssueHandler.handle() method.jira_get_issue: { handle: async (args: unknown) => getIssueHandler.handle(args), },
- src/features/jira/tools/registry/tool.registry.ts:146-152 (registration)Generic MCP server.tool() registration call that registers the jira_get_issue tool using the config from issue-tools.config.ts.server.tool( toolName, config.description, config.params, adaptHandler(config.handler), );