Jira MCP Server

Instructions

Implementation Reference

• src/index.ts:1035-1043 (handler)

  MCP server tool handler that validates input using GetTransitionsSchema and calls jiraClient.getTransitions(issueKey)

  case "jira_get_transitions": {
    const { issueKey } = GetTransitionsSchema.parse(args);
    const transitions = await jiraClient.getTransitions(issueKey);
    return {
      content: [
        { type: "text", text: JSON.stringify(transitions, null, 2) },
      ],
    };
  }

• src/jira-client.ts:165-170 (handler)

  Core implementation in JiraClient: makes API request to /rest/api/2/issue/{issueKey}/transitions to fetch available transitions

    issueKey: string
  ): Promise<{ transitions: JiraTransition[] }> {
    return this.request<{ transitions: JiraTransition[] }>(
      `/issue/${issueKey}/transitions`
    );
  }

• src/index.ts:94-96 (schema)

  Zod schema for input validation: requires issueKey string

  const GetTransitionsSchema = z.object({
    issueKey: z.string().describe("The Jira issue key"),
  });

• src/index.ts:347-357 (registration)

  Tool registration in MCP server's listTools response, including name, description, and inputSchema

  {
    name: "jira_get_transitions",
    description: "Get available transitions for a Jira issue",
    inputSchema: {
      type: "object",
      properties: {
        issueKey: { type: "string", description: "The Jira issue key" },
      },
      required: ["issueKey"],
    },
  },