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,
];

mcp-jira-stdio