Remove redundant listing of additional enums in descriptions

Author: tonytrg

pkg/github/code_scanning.go

@@ -86,12 +86,12 @@ func ListCodeScanningAlerts(getClient GetClientFn, t translations.TranslationHel
 				mcp.Description("The Git reference for the results you want to list."),
 			),
 			mcp.WithString("state",
-				mcp.Description("Filter code scanning alerts by state ('open', 'closed', 'dismissed', 'fixed'). Default: open"),
+				mcp.Description("Filter code scanning alerts by state. Defaults to open"),
 				mcp.DefaultString("open"),
 				mcp.Enum("open", "closed", "dismissed", "fixed"),
 			),
 			mcp.WithString("severity",
-				mcp.Description("If provided, filter code scanning alerts by severity ('critical', 'high', 'medium', 'low', 'warning', 'note', 'error')"),
+				mcp.Description("Filter code scanning alerts by severity"),
 				mcp.Enum("critical", "high", "medium", "low", "warning", "note", "error"),
 			),
 		),

pkg/github/issues.go

@@ -90,7 +90,7 @@ func AddIssueComment(getClient GetClientFn, t translations.TranslationHelperFunc
 			),
 			mcp.WithString("body",
 				mcp.Required(),
-				mcp.Description("Comment text"),
+				mcp.Description("Comment content"),
 			),
 		),
 		func(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
@@ -151,7 +151,7 @@ func SearchIssues(getClient GetClientFn, t translations.TranslationHelperFunc) (
 				mcp.Description("Search query using GitHub issues search syntax"),
 			),
 			mcp.WithString("sort",
-				mcp.Description("Sort field (comments, reactions, created, etc.)"),
+				mcp.Description("Sort field by number of matches of categories, defaults to best match"),
 				mcp.Enum(
 					"comments",
 					"reactions",
@@ -167,7 +167,7 @@ func SearchIssues(getClient GetClientFn, t translations.TranslationHelperFunc) (
 				),
 			),
 			mcp.WithString("order",
-				mcp.Description("Sort order ('asc' or 'desc')"),
+				mcp.Description("Sort order"),
 				mcp.Enum("asc", "desc"),
 			),
 			WithPagination(),
@@ -357,7 +357,7 @@ func ListIssues(getClient GetClientFn, t translations.TranslationHelperFunc) (to
 				mcp.Description("Repository name"),
 			),
 			mcp.WithString("state",
-				mcp.Description("Filter by state ('open', 'closed', 'all')"),
+				mcp.Description("Filter by state"),
 				mcp.Enum("open", "closed", "all"),
 			),
 			mcp.WithArray("labels",
@@ -369,11 +369,11 @@ func ListIssues(getClient GetClientFn, t translations.TranslationHelperFunc) (to
 				),
 			),
 			mcp.WithString("sort",
-				mcp.Description("Sort by ('created', 'updated', 'comments')"),
+				mcp.Description("Sort order"),
 				mcp.Enum("created", "updated", "comments"),
 			),
 			mcp.WithString("direction",
-				mcp.Description("Sort direction ('asc', 'desc')"),
+				mcp.Description("Sort direction"),
 				mcp.Enum("asc", "desc"),
 			),
 			mcp.WithString("since",
@@ -485,7 +485,7 @@ func UpdateIssue(getClient GetClientFn, t translations.TranslationHelperFunc) (t
 				mcp.Description("New description"),
 			),
 			mcp.WithString("state",
-				mcp.Description("New state ('open' or 'closed')"),
+				mcp.Description("New state"),
 				mcp.Enum("open", "closed"),
 			),
 			mcp.WithArray("labels",

pkg/github/pullrequests.go

@@ -94,7 +94,7 @@ func UpdatePullRequest(getClient GetClientFn, t translations.TranslationHelperFu
 				mcp.Description("New description"),
 			),
 			mcp.WithString("state",
-				mcp.Description("New state ('open' or 'closed')"),
+				mcp.Description("New state"),
 				mcp.Enum("open", "closed"),
 			),
 			mcp.WithString("base",
@@ -201,7 +201,7 @@ func ListPullRequests(getClient GetClientFn, t translations.TranslationHelperFun
 				mcp.Description("Repository name"),
 			),
 			mcp.WithString("state",
-				mcp.Description("Filter by state ('open', 'closed', 'all')"),
+				mcp.Description("Filter by state"),
 				mcp.Enum("open", "closed", "all"),
 			),
 			mcp.WithString("head",
@@ -211,11 +211,12 @@ func ListPullRequests(getClient GetClientFn, t translations.TranslationHelperFun
 				mcp.Description("Filter by base branch"),
 			),
 			mcp.WithString("sort",
-				mcp.Description("Sort by ('created', 'updated', 'popularity', 'long-running')"),
+				mcp.Description("Sort by category"),
 				mcp.Enum("created", "updated", "popularity", "long-running"),
 			),
 			mcp.WithString("direction",
-				mcp.Description("Sort direction ('asc', 'desc')"),
+				mcp.Description("Sort direction"),
+				mcp.Enum("asc", "desc"),
 			),
 			WithPagination(),
 		),
@@ -315,7 +316,7 @@ func MergePullRequest(getClient GetClientFn, t translations.TranslationHelperFun
 				mcp.Description("Extra detail for merge commit"),
 			),
 			mcp.WithString("merge_method",
-				mcp.Description("Merge method ('merge', 'squash', 'rebase')"),
+				mcp.Description("Merge method"),
 				mcp.Enum("merge", "squash", "rebase"),
 			),
 		),
@@ -674,21 +675,21 @@ func AddPullRequestReviewComment(getClient GetClientFn, t translations.Translati
 				mcp.Description("The relative path to the file that necessitates a comment. Required unless in_reply_to is specified."),
 			),
 			mcp.WithString("subject_type",
-				mcp.Description("The level at which the comment is targeted ('line', 'file')"),
+				mcp.Description("The level at which the comment is targeted"),
 				mcp.Enum("line", "file"),
 			),
 			mcp.WithNumber("line",
 				mcp.Description("The line of the blob in the pull request diff that the comment applies to. For multi-line comments, the last line of the range"),
 			),
 			mcp.WithString("side",
-				mcp.Description("The side of the diff to comment on ('LEFT', 'RIGHT')"),
+				mcp.Description("The side of the diff to comment on"),
 				mcp.Enum("LEFT", "RIGHT"),
 			),
 			mcp.WithNumber("start_line",
 				mcp.Description("For multi-line comments, the first line of the range that the comment applies to"),
 			),
 			mcp.WithString("start_side",
-				mcp.Description("For multi-line comments, the starting side of the diff that the comment applies to ('LEFT', 'RIGHT')"),
+				mcp.Description("For multi-line comments, the starting side of the diff that the comment applies to"),
 				mcp.Enum("LEFT", "RIGHT"),
 			),
 			mcp.WithNumber("in_reply_to",
@@ -896,7 +897,7 @@ func CreatePullRequestReview(getClient GetClientFn, t translations.TranslationHe
 			),
 			mcp.WithString("event",
 				mcp.Required(),
-				mcp.Description("Review action ('APPROVE', 'REQUEST_CHANGES', 'COMMENT')"),
+				mcp.Description("Review action to perform"),
 				mcp.Enum("APPROVE", "REQUEST_CHANGES", "COMMENT"),
 			),
 			mcp.WithString("commitId",

pkg/github/repositories.go

@@ -93,7 +93,7 @@ func ListCommits(getClient GetClientFn, t translations.TranslationHelperFunc) (t
 				mcp.Description("Repository name"),
 			),
 			mcp.WithString("sha",
-				mcp.Description("Branch name"),
+				mcp.Description("SHA or Branch name"),
 			),
 			WithPagination(),
 		),

pkg/github/search.go

@@ -78,7 +78,7 @@ func SearchCode(getClient GetClientFn, t translations.TranslationHelperFunc) (to
 				mcp.Description("Sort field ('indexed' only)"),
 			),
 			mcp.WithString("order",
-				mcp.Description("Sort order ('asc' or 'desc')"),
+				mcp.Description("Sort order"),
 				mcp.Enum("asc", "desc"),
 			),
 			WithPagination(),
@@ -147,11 +147,11 @@ func SearchUsers(getClient GetClientFn, t translations.TranslationHelperFunc) (t
 				mcp.Description("Search query using GitHub users search syntax"),
 			),
 			mcp.WithString("sort",
-				mcp.Description("Sort field (followers, repositories, joined)"),
+				mcp.Description("Sort field by category"),
 				mcp.Enum("followers", "repositories", "joined"),
 			),
 			mcp.WithString("order",
-				mcp.Description("Sort order ('asc' or 'desc')"),
+				mcp.Description("Sort order"),
 				mcp.Enum("asc", "desc"),
 			),
 			WithPagination(),