Jira MCP Server

Instructions

Implementation Reference

• src/index.ts:927-933 (handler)

  MCP tool handler in the CallToolRequestHandler switch statement. Validates input using GetIssueSchema, calls jiraClient.getIssue(), and returns the issue as JSON text.

  case "jira_get_issue": {
    const { issueKey, expand } = GetIssueSchema.parse(args);
    const issue = await jiraClient.getIssue(issueKey, expand);
    return {
      content: [{ type: "text", text: JSON.stringify(issue, null, 2) }],
    };
  }

• src/index.ts:36-39 (schema)

  Zod schema used for input validation in the tool handler.

  const GetIssueSchema = z.object({
    issueKey: z.string().describe("The Jira issue key (e.g., PROJ-123)"),
    expand: z.array(z.string()).optional().describe("Fields to expand"),
  });

• src/index.ts:211-229 (registration)

  Tool registration in ListToolsRequestHandler, including JSON input schema for MCP client discovery.

  {
    name: "jira_get_issue",
    description: "Get details of a Jira issue by its key",
    inputSchema: {
      type: "object",
      properties: {
        issueKey: {
          type: "string",
          description: "The Jira issue key (e.g., PROJ-123)",
        },
        expand: {
          type: "array",
          items: { type: "string" },
          description: "Fields to expand",
        },
      },
      required: ["issueKey"],
    },
  },

• src/jira-client.ts:52-55 (helper)

  Core implementation in JiraClient class that performs the HTTP request to Jira REST API to fetch the issue details.

  async getIssue(issueKey: string, expand?: string[]): Promise<JiraIssue> {
    const params = expand ? `?expand=${expand.join(",")}` : "";
    return this.request<JiraIssue>(`/issue/${issueKey}${params}`);
  }

• src/types.ts:6-46 (schema)

  TypeScript interface defining the structure of a JiraIssue returned by the API.

  export interface JiraIssue {
    id: string;
    key: string;
    self: string;
    fields: {
      summary: string;
      description?: string;
      status: {
        name: string;
        id: string;
      };
      priority?: {
        name: string;
        id: string;
      };
      assignee?: {
        displayName: string;
        emailAddress: string;
        name: string;
      };
      reporter?: {
        displayName: string;
        emailAddress: string;
        name: string;
      };
      created: string;
      updated: string;
      issuetype: {
        name: string;
        id: string;
      };
      project: {
        key: string;
        name: string;
      };
      labels?: string[];
      components?: Array<{ name: string }>;
      fixVersions?: Array<{ name: string }>;
      [key: string]: unknown;
    };
  }