feat: add GitHub Enterprise tools and update discussions repo parameter description

patrick-knight · patrick-knight · commit 4cf29f997b77 · 2025-08-05T17:28:21.000-05:00
diff --git a/README.md b/README.md
@@ -286,6 +286,7 @@ The following sets of tools are available (all are on by default):
 | `code_security` | Code security related tools, such as GitHub Code Scanning |
 | `dependabot` | Dependabot tools |
 | `discussions` | GitHub Discussions related tools |
+| `enterprise` | GitHub Enterprise related tools |
 | `experiments` | Experimental features that are not considered stable yet |
 | `gists` | GitHub Gist related tools |
 | `issues` | GitHub Issues related tools |
@@ -458,7 +459,7 @@ The following sets of tools are available (all are on by default):
 
 - **list_discussion_categories** - List discussion categories
   - `owner`: Repository owner (string, required)
-  - `repo`: Repository name (string, required)
+  - `repo`: Repository name. If not provided, discussion categories will be queried at the organisation level. (string, optional)
 
 - **list_discussions** - List discussions
   - `after`: Cursor for pagination. Use the endCursor from the previous page's PageInfo for GraphQL APIs. (string, optional)
@@ -473,6 +474,28 @@ The following sets of tools are available (all are on by default):
 
 <details>
 
+<summary>Enterprise</summary>
+
+- **create_enterprise_repository_ruleset** - Create enterprise repository ruleset
+  - `bypass_actors`: The actors that can bypass the rules in this ruleset (object[], optional)
+  - `conditions`: Conditions for when this ruleset applies (object, optional)
+  - `enforcement`: The enforcement level of the ruleset. Can be 'disabled', 'active', or 'evaluate' (string, required)
+  - `enterprise`: Enterprise name (string, required)
+  - `name`: The name of the ruleset (string, required)
+  - `rules`: An array of rules within the ruleset (object[], required)
+  - `target`: The target of the ruleset. Defaults to 'branch'. Can be one of: 'branch', 'tag', or 'push' (string, optional)
+
+- **create_or_update_enterprise_custom_properties** - 
+  - `enterprise`: Enterprise name (string, required)
+  - `properties`: Custom properties as JSON array (string, required)
+
+- **get_enterprise_custom_properties** - 
+  - `enterprise`: Enterprise name (string, required)
+
+</details>
+
+<details>
+
 <summary>Gists</summary>
 
 - **create_gist** - Create Gist
@@ -632,6 +655,22 @@ The following sets of tools are available (all are on by default):
 
 <summary>Organizations</summary>
 
+- **create_or_update_organization_custom_properties** - 
+  - `org`: Organization name (string, required)
+  - `properties`: Custom properties as JSON array (string, required)
+
+- **create_organization_repository_ruleset** - Create organization repository ruleset
+  - `bypass_actors`: The actors that can bypass the rules in this ruleset (object[], optional)
+  - `conditions`: Conditions for when this ruleset applies (object, optional)
+  - `enforcement`: The enforcement level of the ruleset. Can be 'disabled', 'active', or 'evaluate' (string, required)
+  - `name`: The name of the ruleset (string, required)
+  - `org`: Organization name (string, required)
+  - `rules`: An array of rules within the ruleset (object[], required)
+  - `target`: The target of the ruleset. Defaults to 'branch'. Can be one of: 'branch', 'tag', or 'push' (string, optional)
+
+- **get_organization_custom_properties** - 
+  - `org`: Organization name (string, required)
+
 - **get_organization_repository_ruleset** - Get organization repository ruleset
   - `org`: Organization name (string, required)
   - `rulesetId`: Ruleset ID (number, required)
@@ -806,12 +845,27 @@ The following sets of tools are available (all are on by default):
   - `repo`: Repository name (string, required)
   - `sha`: Required if updating an existing file. The blob SHA of the file being replaced. (string, optional)
 
+- **create_or_update_repository_custom_properties** - 
+  - `owner`: Repository owner (string, required)
+  - `properties`: Custom properties as JSON array (string, required)
+  - `repo`: Repository name (string, required)
+
 - **create_repository** - Create repository
   - `autoInit`: Initialize with README (boolean, optional)
   - `description`: Repository description (string, optional)
   - `name`: Repository name (string, required)
   - `private`: Whether repo should be private (boolean, optional)
 
+- **create_repository_ruleset** - Create repository ruleset
+  - `bypass_actors`: The actors that can bypass the rules in this ruleset (object[], optional)
+  - `conditions`: Conditions for when this ruleset applies (object, optional)
+  - `enforcement`: The enforcement level of the ruleset. Can be 'disabled', 'active', or 'evaluate' (string, required)
+  - `name`: The name of the ruleset (string, required)
+  - `owner`: Repository owner (string, required)
+  - `repo`: Repository name (string, required)
+  - `rules`: An array of rules within the ruleset (object[], required)
+  - `target`: The target of the ruleset. Defaults to 'branch'. Can be one of: 'branch', 'tag', or 'push' (string, optional)
+
 - **delete_file** - Delete file
   - `branch`: Branch to delete the file from (string, required)
   - `message`: Commit message (string, required)
@@ -838,6 +892,15 @@ The following sets of tools are available (all are on by default):
   - `repo`: Repository name (string, required)
   - `sha`: Accepts optional commit SHA. If specified, it will be used instead of ref (string, optional)
 
+- **get_repository_custom_properties** - 
+  - `owner`: Repository owner (string, required)
+  - `repo`: Repository name (string, required)
+
+- **get_repository_rule_suite** - Get repository rule suite
+  - `owner`: Repository owner (string, required)
+  - `repo`: Repository name (string, required)
+  - `ruleSuiteId`: Rule suite ID (number, required)
+
 - **get_repository_rules_for_branch** - Get rules for branch
   - `branch`: Branch name (string, required)
   - `owner`: Repository owner (string, required)
@@ -870,6 +933,16 @@ The following sets of tools are available (all are on by default):
   - `repo`: Repository name (string, required)
   - `sha`: Commit SHA, branch or tag name to list commits of. If not provided, uses the default branch of the repository. If a commit SHA is provided, will list commits up to that SHA. (string, optional)
 
+- **list_repository_rule_suites** - List repository rule suites
+  - `actorName`: The handle for the GitHub user account to filter on (string, optional)
+  - `owner`: Repository owner (string, required)
+  - `page`: Page number for pagination (min 1) (number, optional)
+  - `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
+  - `ref`: The name of the ref (branch, tag, etc.) to filter rule suites by (string, optional)
+  - `repo`: Repository name (string, required)
+  - `ruleSuiteResult`: The rule suite result to filter by. Options: pass, fail, bypass (string, optional)
+  - `timePeriod`: The time period to filter by. Options: hour, day, week, month (string, optional)
+
 - **list_repository_rulesets** - List repository rulesets
   - `includesParents`: Include rulesets configured at higher levels that also apply (boolean, optional)
   - `owner`: Repository owner (string, required)
diff --git a/docs/remote-server.md b/docs/remote-server.md
@@ -24,6 +24,7 @@ Below is a table of available toolsets for the remote GitHub MCP Server. Each to
 | Code Security  | Code security related tools, such as GitHub Code Scanning | https://api.githubcopilot.com/mcp/x/code_security     | [Install](https://insiders.vscode.dev/redirect/mcp/install?name=gh-code_security&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fcode_security%22%7D)             | [read-only](https://api.githubcopilot.com/mcp/x/code_security/readonly)                                        | [Install read-only](https://insiders.vscode.dev/redirect/mcp/install?name=gh-code_security&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fcode_security%2Freadonly%22%7D)                                                              |
 | Dependabot     | Dependabot tools                                 | https://api.githubcopilot.com/mcp/x/dependabot        | [Install](https://insiders.vscode.dev/redirect/mcp/install?name=gh-dependabot&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fdependabot%22%7D)                   | [read-only](https://api.githubcopilot.com/mcp/x/dependabot/readonly)                                           | [Install read-only](https://insiders.vscode.dev/redirect/mcp/install?name=gh-dependabot&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fdependabot%2Freadonly%22%7D)                                                                    |
 | Discussions    | GitHub Discussions related tools                 | https://api.githubcopilot.com/mcp/x/discussions       | [Install](https://insiders.vscode.dev/redirect/mcp/install?name=gh-discussions&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fdiscussions%22%7D)                 | [read-only](https://api.githubcopilot.com/mcp/x/discussions/readonly)                                          | [Install read-only](https://insiders.vscode.dev/redirect/mcp/install?name=gh-discussions&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fdiscussions%2Freadonly%22%7D)                                                                  |
+| Enterprise     | GitHub Enterprise related tools                  | https://api.githubcopilot.com/mcp/x/enterprise        | [Install](https://insiders.vscode.dev/redirect/mcp/install?name=gh-enterprise&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fenterprise%22%7D)                   | [read-only](https://api.githubcopilot.com/mcp/x/enterprise/readonly)                                           | [Install read-only](https://insiders.vscode.dev/redirect/mcp/install?name=gh-enterprise&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fenterprise%2Freadonly%22%7D)                                                                    |
 | Experiments    | Experimental features that are not considered stable yet | https://api.githubcopilot.com/mcp/x/experiments       | [Install](https://insiders.vscode.dev/redirect/mcp/install?name=gh-experiments&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fexperiments%22%7D)                 | [read-only](https://api.githubcopilot.com/mcp/x/experiments/readonly)                                          | [Install read-only](https://insiders.vscode.dev/redirect/mcp/install?name=gh-experiments&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fexperiments%2Freadonly%22%7D)                                                                  |
 | Gists          | GitHub Gist related tools                        | https://api.githubcopilot.com/mcp/x/gists             | [Install](https://insiders.vscode.dev/redirect/mcp/install?name=gh-gists&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fgists%22%7D)                             | [read-only](https://api.githubcopilot.com/mcp/x/gists/readonly)                                                | [Install read-only](https://insiders.vscode.dev/redirect/mcp/install?name=gh-gists&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fgists%2Freadonly%22%7D)                                                                              |
 | Issues         | GitHub Issues related tools                      | https://api.githubcopilot.com/mcp/x/issues            | [Install](https://insiders.vscode.dev/redirect/mcp/install?name=gh-issues&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fissues%22%7D)                           | [read-only](https://api.githubcopilot.com/mcp/x/issues/readonly)                                               | [Install read-only](https://insiders.vscode.dev/redirect/mcp/install?name=gh-issues&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fissues%2Freadonly%22%7D)                                                                            |
