jira_get_project_info
Retrieve comprehensive project details from Jira including components, versions, issue types, roles, and insights for better project management and analysis.
Instructions
Retrieves detailed information about a project (components, versions, issue types, roles, insights). More comprehensive than the basic project list.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| expand | No | Additional project details to include (e.g., ["description", "lead", "issueTypes", "versions"]) | |
| projectKey | Yes | Project key to get detailed information for |
Implementation Reference
- src/tools/get-project-info.ts:36-51 (handler)The main handler function that validates input, fetches project details from Jira API, formats the response, and handles errors for the jira_get_project_info tool.export async function handleGetProjectInfo(input: unknown): Promise<McpToolResponse> { try { const validated = validateInput(GetProjectInfoInputSchema, input); log.info(`Getting detailed project information for ${validated.projectKey}...`); const project = await getProjectDetails(validated.projectKey, validated.expand); log.info(`Retrieved project details for ${project.key}`); return formatProjectDetailsResponse(project); } catch (error) { log.error('Error in handleGetProjectInfo:', error); return handleError(error); } }
- src/tools/get-project-info.ts:13-34 (schema)The MCP Tool definition including name, description, and input schema for jira_get_project_info.export const getProjectInfoTool: Tool = { name: TOOL_NAMES.GET_PROJECT_INFO, description: 'Retrieves detailed information about a project (components, versions, issue types, roles, insights). More comprehensive than the basic project list.', inputSchema: { type: 'object', properties: { projectKey: { type: 'string', description: 'Project key to get detailed information for', }, expand: { type: 'array', items: { type: 'string' }, description: 'Additional project details to include (e.g., ["description", "lead", "issueTypes", "versions"])', default: [], }, }, required: ['projectKey'], }, };
- src/types/tools.ts:199-207 (schema)Zod schema for input validation used in the handler, with project key validation.export const GetProjectInfoInputSchema = z.object({ projectKey: z .string() .describe('Project key to get detailed information for') .refine((v) => isValidProjectKey(v), 'Invalid project key format'), expand: z.array(z.string()).optional().describe('Additional project details to include'), }); export type GetProjectInfoInput = z.infer<typeof GetProjectInfoInputSchema>;
- src/index.ts:32-49 (registration)Registration of tool handlers in the central map used by the MCP server for call_tool requests. Includes jira_get_project_info mapped to its handler.const toolHandlers = new Map<string, (input: unknown) => Promise<any>>([ [TOOL_NAMES.GET_VISIBLE_PROJECTS, tools.handleGetVisibleProjects], [TOOL_NAMES.GET_ISSUE, tools.handleGetIssue], [TOOL_NAMES.SEARCH_ISSUES, tools.handleSearchIssues], [TOOL_NAMES.GET_MY_ISSUES, tools.handleGetMyIssues], [TOOL_NAMES.GET_ISSUE_TYPES, tools.handleGetIssueTypes], [TOOL_NAMES.GET_USERS, tools.handleGetUsers], [TOOL_NAMES.GET_PRIORITIES, tools.handleGetPriorities], [TOOL_NAMES.GET_STATUSES, tools.handleGetStatuses], [TOOL_NAMES.CREATE_ISSUE, tools.handleCreateIssue], [TOOL_NAMES.UPDATE_ISSUE, tools.handleUpdateIssue], [TOOL_NAMES.ADD_COMMENT, tools.handleAddComment], [TOOL_NAMES.GET_PROJECT_INFO, tools.handleGetProjectInfo], [TOOL_NAMES.CREATE_SUBTASK, tools.handleCreateSubtask], [TOOL_NAMES.GET_CREATE_META, tools.handleGetCreateMeta], [TOOL_NAMES.GET_CUSTOM_FIELDS, tools.handleGetCustomFields], [TOOL_NAMES.CREATE_ISSUE_LINK, tools.handleCreateIssueLink], ]);
- src/index.ts:52-69 (registration)Registration of all Tool objects in the array returned by list_tools, including getProjectInfoTool.const allTools = [ tools.getVisibleProjectsTool, tools.getIssueTool, tools.searchIssuesTool, tools.getMyIssuesTool, tools.getIssueTypesTool, tools.getUsersTool, tools.getPrioritiesTool, tools.getStatusesTool, tools.createIssueTool, tools.updateIssueTool, tools.addCommentTool, tools.getProjectInfoTool, tools.createSubtaskTool, tools.getCreateMetaTool, tools.getCustomFieldsTool, tools.createIssueLinkTool, ];