MCP Zephyr

Instructions

Implementation Reference

• src/tools/reference-data-tools.js:77-111 (handler)

  The handler function for the 'get_reference_data' tool. It fetches statuses and priorities concurrently using ZephyrClient and returns a formatted JSON response with the data and usage notes. Handles errors by returning an error message.

  async function getReferenceData() {
    try {
      const [statusesResponse, prioritiesResponse] = await Promise.all([
        client.getStatuses(),
        client.getPriorities()
      ]);
  
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify({
              statuses: statusesResponse.values || statusesResponse,
              priorities: prioritiesResponse.values || prioritiesResponse,
              summary: {
                totalStatuses: (statusesResponse.values || statusesResponse).length,
                totalPriorities: (prioritiesResponse.values || prioritiesResponse).length
              },
              usage: 'Use these values for statusName and priorityName fields when creating/updating test cases'
            }, null, 2)
          }
        ]
      };
    } catch (error) {
      return {
        content: [
          {
            type: 'text',
            text: formatError(error, 'fetching reference data')
          }
        ],
        isError: true
      };
    }
  }

• src/tools/reference-data-tools.js:135-138 (schema)

  Input schema definition for the 'get_reference_data' tool, specifying an empty object (no required input parameters).

  inputSchema: {
    type: 'object',
    properties: {}
  },

• src/tools/reference-data-tools.js:132-140 (registration)

  Registration of the 'get_reference_data' tool within the referenceDataTools array, linking the name, description, schema, and handler function.

  {
    name: 'get_reference_data',
    description: 'Get all reference data (statuses and priorities) in a single call',
    inputSchema: {
      type: 'object',
      properties: {}
    },
    handler: getReferenceData
  }