Jira MCP Server

Instructions

Implementation Reference

• src/index.ts:40-59 (registration)

  Registration of the 'execute_jql' tool in the ListTools response, including name, description, and input schema.

  {
    name: 'execute_jql',
    description:
      'Execute a JQL query on Jira on the api /rest/api/3/search/jql. Do not use markdown in your query.',
    inputSchema: {
      type: 'object',
      properties: {
        jql: {
          type: 'string',
          description: 'JQL query string',
        },
        number_of_results: {
          type: 'integer',
          description: 'Number of results to return',
          default: 1,
        },
      },
      required: ['jql'],
    },
  },

• src/index.ts:44-58 (schema)

  Input schema for the 'execute_jql' tool defining parameters jql (required string) and number_of_results (optional integer, default 1).

  inputSchema: {
    type: 'object',
    properties: {
      jql: {
        type: 'string',
        description: 'JQL query string',
      },
      number_of_results: {
        type: 'integer',
        description: 'Number of results to return',
        default: 1,
      },
    },
    required: ['jql'],
  },

• src/index.ts:432-452 (handler)

  Core handler function that executes the JQL query by making an authenticated GET request to Jira's /rest/api/3/search/jql endpoint with specified parameters.

  async function executeJQL(jql: string, maxResults: number): Promise<any> {
    try {
      const params = {
        jql, // JQL query string
        maxResults, // Adjust as needed
        fields: '*all', // Request all fields
      };
  
      const response = await axios.get(`${JIRA_URL}/rest/api/3/search/jql`, {
        headers: getAuthHeaders().headers,
        params,
      });
  
      return response.data;
    } catch (error: any) {
      //return the error in a json
      return {
        error: error.response.data,
      };
    }
  }

• src/index.ts:707-728 (handler)

  MCP CallToolRequestSchema handler case for 'execute_jql': validates input, calls executeJQL, and returns the JSON response as text content.

  case 'execute_jql': {
    const jql = String(request.params.arguments?.jql);
    const number_of_results = Number(
      request.params.arguments?.number_of_results ?? 1,
    );
  
    if (!jql) {
      throw new Error('JQL query is required');
    }
  
    const response = await executeJQL(jql, number_of_results);
  
    // Return the entire data from the response
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(response, null, 2), // Pretty print JSON
        },
      ],
    };
  }