You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+17Lines changed: 17 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -591,12 +591,14 @@ The following sets of tools are available (all are on by default):
591
591
-**update_issue** - Edit issue
592
592
-`assignees`: New assignees (string[], optional)
593
593
-`body`: New description (string, optional)
594
+
-`duplicate_of`: Issue number that this issue is a duplicate of. Only used when state_reason is 'duplicate'. (number, optional)
594
595
-`issue_number`: Issue number to update (number, required)
595
596
-`labels`: New labels (string[], optional)
596
597
-`milestone`: New milestone number (number, optional)
597
598
-`owner`: Repository owner (string, required)
598
599
-`repo`: Repository name (string, required)
599
600
-`state`: New state (string, optional)
601
+
-`state_reason`: Reason for the state change. Ignored unless state is changed. (string, optional)
600
602
-`title`: New title (string, optional)
601
603
-`type`: New issue type (string, optional)
602
604
@@ -875,6 +877,13 @@ The following sets of tools are available (all are on by default):
875
877
-`perPage`: Results per page for pagination (min 1, max 100) (number, optional)
876
878
-`repo`: Repository name (string, required)
877
879
880
+
-**list_starred_repositories** - List starred repositories
881
+
-`direction`: The direction to sort the results by. (string, optional)
882
+
-`page`: Page number for pagination (min 1) (number, optional)
883
+
-`perPage`: Results per page for pagination (min 1, max 100) (number, optional)
884
+
-`sort`: How to sort the results. Can be either 'created' (when the repository was starred) or 'updated' (when the repository was last pushed to). (string, optional)
885
+
-`username`: Username to list starred repositories for. Defaults to the authenticated user. (string, optional)
886
+
878
887
-**list_tags** - List tags
879
888
-`owner`: Repository owner (string, required)
880
889
-`page`: Page number for pagination (min 1) (number, optional)
@@ -901,6 +910,14 @@ The following sets of tools are available (all are on by default):
901
910
-`perPage`: Results per page for pagination (min 1, max 100) (number, optional)
You can configure toolsets and readonly mode by providing HTTP headers in your server configuration.
50
+
The Remote GitHub MCP server has optional headers equivalent to the Local server env vars:
51
51
52
-
The headers are:
53
-
-`X-MCP-Toolsets=<toolset>,<toolset>...`
54
-
-`X-MCP-Readonly=true`
52
+
-`X-MCP-Toolsets`: Comma-separated list of toolsets to enable. E.g. "repos,issues".
53
+
- Equivalent to `GITHUB_TOOLSETS` env var for Local server.
54
+
- If the list is empty, default toolsets will be used. If a bad toolset is provided, the server will fail to start and emit a 400 bad request status. Whitespace is ignored.
55
+
-`X-MCP-Readonly`: Enables only "read" tools.
56
+
- Equivalent to `GITHUB_READ_ONLY` env var for Local server.
57
+
- If this header is empty, "false", "f", "no", "n", "0", or "off" (ignoring whitespace and case), it will be interpreted as false. All other values are interpreted as true.
58
+
59
+
Example:
60
+
61
+
```json
62
+
{
63
+
"type": "http",
64
+
"url": "https://api.githubcopilot.com/mcp/",
65
+
"headers": {
66
+
"X-MCP-Toolsets": "repos,issues",
67
+
"X-MCP-Readonly": "true"
68
+
}
69
+
}
70
+
```
71
+
72
+
### URL Path Parameters
73
+
74
+
The Remote GitHub MCP server also supports the URL path parameters:
75
+
76
+
-`/x/{toolset}`
77
+
-`/x/{toolset}/readonly`
78
+
-`/readonly`
79
+
80
+
Note: `{toolset}` can only been a single toolset, not a comma-separated list. To combine multiple toolsets, use the `X-MCP-Toolsets` header instead.
0 commit comments