Expose checks (#41)

* Expose checks

---------

Co-authored-by: Farjaad Rawasia <[email protected]>

Author: Farjaad

.changes/unreleased/Added-20250521-115312.yaml

@@ -0,0 +1,3 @@
+kind: Added
+body: Add checks tool
+time: 2025-05-21T11:53:12.119491-04:00

README.md

@@ -27,6 +27,7 @@ This MCP ([Model Context Protocol](https://modelcontextprotocol.io/introduction)
 Currently, the MCP server only uses read-only access to your OpsLevel account and can read data from the following resources:
 
 - Actions
+- Checks
 - Components
 - Documentation (API & Tech Docs)
 - Domains

src/cmd/root.go

@@ -39,6 +39,23 @@ type serializedInfrastructureResource struct {
 	ProviderType string
 }
 
+type serializedLevel struct {
+	Alias string
+	Index int
+}
+
+type serializedCheck struct {
+	Id          string
+	Name        string
+	Owner       string
+	Description string
+	Notes       string
+	Enabled     bool
+	Type        string
+	Level       serializedLevel
+	Category    string
+}
+
 // newToolResult creates a CallToolResult for the passed object handling any json marshaling errors
 func newToolResult(obj any, err error) (*mcp.CallToolResult, error) {
 	if err != nil {
@@ -345,6 +362,41 @@ var rootCmd = &cobra.Command{
 				return newToolResult(resp, err)
 			})
 
+		// Register checks
+		s.AddTool(
+			mcp.NewTool(
+				"checks",
+				mcp.WithDescription("Get all the checks in the OpsLevel account. Checks provide a foundation for evaluating the maturity of software components, allowing for the definition and enforcement of criteria that ensure components are built and maintained according to best practices. Check priority is determined by level index, not level name—lower index means higher priority."),
+				mcp.WithToolAnnotation(mcp.ToolAnnotation{
+					Title:           "Checks in OpsLevel",
+					ReadOnlyHint:    true,
+					DestructiveHint: false,
+					IdempotentHint:  true,
+					OpenWorldHint:   true,
+				}),
+			),
+			func(ctx context.Context, req mcp.CallToolRequest) (*mcp.CallToolResult, error) {
+				resp, err := client.ListChecks(nil)
+				if err != nil {
+					return nil, err
+				}
+				var checks []serializedCheck
+				for _, node := range resp.Nodes {
+					checks = append(checks, serializedCheck{
+						Id:          string(node.Id),
+						Name:        node.Name,
+						Owner:       node.Owner.Team.Alias,
+						Description: node.Description,
+						Notes:       node.Notes,
+						Type:        string(node.Type),
+						Level:       serializedLevel{Alias: node.Level.Alias, Index: node.Level.Index},
+						Category:    node.Category.Name,
+						Enabled:     node.Enabled,
+					})
+				}
+				return newToolResult(checks, nil)
+			})
+
 		log.Info().Msg("Starting MCP server...")
 		if err := server.ServeStdio(s); err != nil {
 			if err == context.Canceled {