Grafana MCP Server

Instructions

Implementation Reference

• src/tools/admin.ts:37-62 (handler)

  The ToolDefinition export including the handler function that executes the tool logic by fetching users via GrafanaClient and formatting the response.

  export const listUsersByOrg: ToolDefinition = {
    name: 'list_users_by_org',
    description: 'List users by organization. Returns a list of users with details like userid, email, role etc',
    inputSchema: ListUsersByOrgSchema,
    handler: async (_params, context: ToolContext) => {
      try {
        const client = new GrafanaClient(context.config.grafanaConfig);
        const users = await client.listUsers();
        
        // Format the response
        const formatted = users.map(user => ({
          id: user.id,
          email: user.email,
          name: user.name,
          login: user.login,
          role: user.role,
          lastSeenAt: user.lastSeenAt,
          isDisabled: user.isDisabled,
        }));
        
        return createToolResult(formatted);
      } catch (error: any) {
        return createErrorResult(error.message);
      }
    },
  };

• src/tools/admin.ts:10-10 (schema)

  Zod input schema for the list_users_by_org tool (accepts no parameters).

  const ListUsersByOrgSchema = z.object({});

• src/tools/admin.ts:66-66 (registration)

  Registration of the list_users_by_org tool via server.registerTool call within registerAdminTools function.

  server.registerTool(listUsersByOrg);

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

  Invocation of registerAdminTools which registers the admin tools including list_users_by_org.

  registerAdminTools(server);