Grafana MCP Server

Instructions

Implementation Reference

• src/tools/incident.ts:93-109 (handler)

  The main handler for the 'get_incident' tool, which creates an API client and fetches the incident details by ID using Grafana IncidentService.

  export const getIncident: ToolDefinition = {
    name: 'get_incident',
    description: 'Get a single incident by ID. Returns the full incident details',
    inputSchema: GetIncidentSchema,
    handler: async (params, context: ToolContext) => {
      try {
        const client = createIncidentClient(context.config.grafanaConfig);
        const response = await client.get(`/IncidentService.GetIncident`, {
          params: { incidentID: params.id },
        });
        
        return createToolResult(response.data.incident);
      } catch (error: any) {
        return createErrorResult(error.response?.data?.message || error.message);
      }
    },
  };

• src/tools/incident.ts:12-14 (schema)

  Zod input schema for 'get_incident' tool, defining the required 'id' parameter.

  const GetIncidentSchema = z.object({
    id: z.string().describe('The ID of the incident to retrieve'),
  });

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

  Registration function that registers the 'getIncident' tool (and others) with the MCP server.

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

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

  Helper function to create the Axios client for Grafana Incident API, used by the get_incident handler.

  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,
    });
  }