Grafana MCP Server

Instructions

Implementation Reference

• src/tools/oncall.ts:156-191 (handler)

  The ToolDefinition export for 'get_current_oncall_users', which includes the handler function that fetches the schedule data from Grafana OnCall API and extracts the currently on-call users.

  export const getCurrentOncallUsers: ToolDefinition = {
    name: 'get_current_oncall_users',
    description: 'Get the list of users currently on-call for a specific Grafana OnCall schedule',
    inputSchema: GetCurrentOncallUsersSchema,
    handler: async (params, context: ToolContext) => {
      try {
        const client = createOncallClient(context.config.grafanaConfig);
        
        const response = await client.get(`/schedules/${params.scheduleId}`);
        const schedule = response.data;
        
        // Get users currently on call
        const onCallNow = schedule.on_call_now || [];
        const users = [];
        
        for (const userInfo of onCallNow) {
          if (userInfo.user) {
            users.push({
              id: userInfo.user.id,
              username: userInfo.user.username,
              email: userInfo.user.email,
              name: userInfo.user.name,
            });
          }
        }
        
        return createToolResult({
          scheduleId: schedule.id,
          scheduleName: schedule.name,
          currentOncallUsers: users,
        });
      } catch (error: any) {
        return createErrorResult(error.response?.data?.detail || error.message);
      }
    },
  };

• src/tools/oncall.ts:22-24 (schema)

  Zod schema defining the input for the 'get_current_oncall_users' tool, requiring a scheduleId.

  const GetCurrentOncallUsersSchema = z.object({
    scheduleId: z.string().describe('The ID of the schedule to get current on-call users for'),
  });

• src/tools/oncall.ts:220-226 (registration)

  The registration function for all OnCall tools, which registers 'get_current_oncall_users' with the MCP server.

  export function registerOncallTools(server: any) {
    server.registerTool(listOncallSchedules);
    server.registerTool(listOncallTeams);
    server.registerTool(listOncallUsers);
    server.registerTool(getCurrentOncallUsers);
    server.registerTool(getOncallShift);
  }

• src/tools/oncall.ts:31-47 (helper)

  Helper function to create an Axios client instance for interacting with the Grafana OnCall API, used by the tool handler.

  function createOncallClient(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-oncall-app/resources/api/v1`,
      headers,
      timeout: 30000,
    });
  }