Jira MCP Server

Instructions

Implementation Reference

• src/handlers/transition-handlers.ts:7-36 (handler)

  The core handler function that implements the get_transitions tool logic: fetches available transitions for a Jira issue using the API and returns formatted text response.

  async handleGetTransitions(args: any) {
    try {
      const { issueKey } = args;
  
      if (!issueKey) {
        throw new Error('issueKey is required');
      }
  
      const result = await this.apiClient.get(`/issue/${issueKey}/transitions`);
  
      return {
        content: [
          {
            type: 'text',
            text: JiraFormatters.formatTransitions(result.transitions),
          },
        ],
      };
    } catch (error: any) {
      return {
        content: [
          {
            type: 'text',
            text: JiraFormatters.formatError(error),
          },
        ],
        isError: true,
      };
    }
  }

• src/tools/definitions.ts:223-236 (schema)

  Defines the tool schema including name, description, and inputSchema requiring 'issueKey'.

  {
    name: 'get_transitions',
    description: 'Get available status transitions for a Jira issue',
    inputSchema: {
      type: 'object',
      properties: {
        issueKey: {
          type: 'string',
          description: 'The issue key (e.g., PROJ-123)',
        },
      },
      required: ['issueKey'],
    },
  },

• src/index.ts:128-129 (registration)

  Registers the tool in the MCP server by handling the CallToolRequest for 'get_transitions' and delegating to the handler.

  case 'get_transitions':
    return this.transitionHandlers.handleGetTransitions(request.params.arguments);