jira_get_my_issues
Retrieve your assigned Jira issues sorted by most recent updates. Supports pagination and field selection to access specific issue details.
Instructions
Retrieves issues assigned to current user, sorted by most recently updated first. Supports pagination and field selection.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| expand | No | Additional details to include for each issue | |
| fields | No | Specific fields to retrieve for each issue | |
| maxResults | No | Maximum number of results to return | |
| startAt | No | Index of first result to return (for pagination) |
Implementation Reference
- src/tools/get-my-issues.ts:48-72 (handler)The main handler function that validates input, calls the getMyIssues API helper, logs progress, formats the response, and handles errors.export async function handleGetMyIssues(input: unknown): Promise<McpToolResponse> { try { const validated = validateInput(GetMyIssuesInputSchema, input); log.info('Getting issues assigned to current user...'); const getParams: any = {}; if (validated.nextPageToken !== undefined) getParams.nextPageToken = validated.nextPageToken; if (validated.maxResults !== undefined) getParams.maxResults = validated.maxResults; if (validated.fields !== undefined) getParams.fields = validated.fields; if (validated.expand !== undefined) getParams.expand = validated.expand; const result = await getMyIssues(getParams); log.info( `Found ${result.total ?? 0} issue(s) assigned to you, showing ${result.issues.length}` ); return formatSearchResultsResponse(result); } catch (error) { log.error('Error in handleGetMyIssues:', error); return handleError(error); } }
- src/types/tools.ts:112-127 (schema)Zod schema for validating the input parameters of the jira_get_my_issues tool.export const GetMyIssuesInputSchema = z.object({ nextPageToken: z .string() .optional() .describe( 'Token for pagination. Omit for first page, use value from previous response for next page.' ), maxResults: z .number() .min(1) .max(100) .default(50) .describe('Maximum number of results to return per page'), fields: z.array(z.string()).optional().describe('Specific fields to retrieve'), expand: z.array(z.string()).optional().describe('Additional details to include'), });
- src/utils/api-helpers.ts:410-430 (helper)API helper function that constructs the JQL query for user's assigned issues and calls the generic searchIssues function.export async function getMyIssues( options: { nextPageToken?: string; maxResults?: number; fields?: string[]; expand?: string[]; } = {} ): Promise<JiraSearchResult> { const jql = `assignee = currentUser() ORDER BY updated DESC`; const searchParams: any = { jql, maxResults: options.maxResults || 50, }; if (options.nextPageToken !== undefined) searchParams.nextPageToken = options.nextPageToken; if (options.fields !== undefined) searchParams.fields = options.fields; if (options.expand !== undefined) searchParams.expand = options.expand; return await searchIssues(searchParams); }
- src/tools/get-my-issues.ts:13-46 (registration)Tool object definition including the name 'jira_get_my_issues', description, and MCP-compatible inputSchema. Exported and re-exported from src/tools/index.ts.export const getMyIssuesTool: Tool = { name: TOOL_NAMES.GET_MY_ISSUES, description: 'Retrieves issues assigned to current user, sorted by most recently updated first. Supports pagination and field selection. For pagination, use nextPageToken from previous response.', inputSchema: { type: 'object', properties: { nextPageToken: { type: 'string', description: 'Token for pagination. Omit for first page, use value from previous response for next page.', }, maxResults: { type: 'number', description: 'Maximum number of results to return per page', minimum: 1, maximum: 100, default: 50, }, fields: { type: 'array', items: { type: 'string' }, description: 'Specific fields to retrieve for each issue', }, expand: { type: 'array', items: { type: 'string' }, description: 'Additional details to include for each issue', default: [], }, }, required: [], }, };
- src/config/constants.ts:28-28 (registration)Constant definition for the tool name used in the tool registration.GET_MY_ISSUES: 'jira_get_my_issues',