create_incident

Instructions

Implementation Reference

• src/tools/incident.ts:111-154 (handler)

  The core handler implementation for the 'create_incident' tool. It constructs incident data from input params, optionally adds attachments, and posts to the Grafana Incident API using an axios client.

  export const createIncident: ToolDefinition = {
    name: 'create_incident',
    description: 'Create a new Grafana incident. Requires title, severity, and room prefix',
    inputSchema: CreateIncidentSchema,
    handler: async (params, context: ToolContext) => {
      try {
        const client = createIncidentClient(context.config.grafanaConfig);
        
        const incidentData: any = {
          title: params.title,
          severity: params.severity,
          roomPrefix: params.roomPrefix,
        };
        
        if (params.status) incidentData.status = params.status;
        if (params.isDrill !== undefined) incidentData.isDrill = params.isDrill;
        if (params.labels) incidentData.labels = params.labels;
        
        const attachments = [];
        if (params.attachUrl) {
          attachments.push({
            attachmentID: 'attach-1',
            url: params.attachUrl,
            useToSummarize: true,
            caption: params.attachCaption,
          });
        }
        
        const response = await client.post('/IncidentService.CreateIncident', {
          incident: incidentData,
          attachments,
        });
        
        return createToolResult({
          incidentID: response.data.incident.incidentID,
          title: response.data.incident.title,
          status: response.data.incident.status,
          message: 'Incident created successfully',
        });
      } catch (error: any) {
        return createErrorResult(error.response?.data?.message || error.message);
      }
    },
  };

• src/tools/incident.ts:16-30 (schema)

  Zod input schema defining parameters for creating an incident, including title, severity, roomPrefix, and optional fields like status, labels, and attachments.

  const CreateIncidentSchema = z.object({
    title: z.string().describe('The title of the incident'),
    severity: z.string().describe('The severity of the incident'),
    status: z.string().optional().describe('The status of the incident'),
    roomPrefix: z.string().describe('The prefix of the room to create the incident in'),
    isDrill: z.boolean().optional().describe('Whether the incident is a drill'),
    labels: z.array(z.object({
      key: z.string(),
      label: z.string(),
      description: z.string().optional(),
      colorHex: z.string().optional(),
    })).optional().describe('Labels to add to the incident'),
    attachUrl: z.string().optional().describe('URL of the attachment'),
    attachCaption: z.string().optional().describe('Caption of the attachment'),
  });

• src/tools/incident.ts:187-192 (registration)

  Registration function for all incident-related tools, including 'create_incident'.

  export function registerIncidentTools(server: any) {
    server.registerTool(listIncidents);
    server.registerTool(getIncident);
    server.registerTool(createIncident);
    server.registerTool(addActivityToIncident);
  }

• src/cli.ts:114-114 (registration)

  Invocation of the incident tools registration in the main CLI entrypoint, conditional on the 'incident' tool category being enabled.

  registerIncidentTools(server);

• src/tools/incident.ts:39-55 (helper)

  Helper function that creates an authenticated axios client for the Grafana Incident API, used by all incident tools including create_incident.

  function createIncidentClient(config: any) {
    const headers: any = {
      'User-Agent': 'mcp-grafana/1.0.0',
    };
    
    if (config.serviceAccountToken) {
      headers['Authorization'] = `Bearer ${config.serviceAccountToken}`;
    } else if (config.apiKey) {
      headers['Authorization'] = `Bearer ${config.apiKey}`;
    }
    
    return axios.create({
      baseURL: `${config.url}/api/plugins/grafana-incident-app/resources/api/v1`,
      headers,
      timeout: 30000,
    });
  }