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
+15Lines changed: 15 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -288,6 +288,7 @@ The following sets of tools are available (all are on by default):
288
288
|`issues`| GitHub Issues related tools |
289
289
|`notifications`| GitHub Notifications related tools |
290
290
|`orgs`| GitHub Organization related tools |
291
+
|`projects`| GitHub Projects related tools |
291
292
|`pull_requests`| GitHub Pull Request related tools |
292
293
|`repos`| GitHub Repository related tools |
293
294
|`secret_protection`| Secret protection related tools, such as GitHub Secret Scanning |
@@ -655,6 +656,20 @@ The following sets of tools are available (all are on by default):
655
656
656
657
<details>
657
658
659
+
<summary>Projects</summary>
660
+
661
+
-**list_projects** - List projects
662
+
-`after`: Cursor for items after (forward pagination) (string, optional)
663
+
-`before`: Cursor for items before (backwards pagination) (string, optional)
664
+
-`owner`: If owner_type == user it is the handle for the GitHub user account. If owner_type == organization it is the name of the organization. The name is not case sensitive. (string, required)
665
+
-`owner_type`: Owner type (string, required)
666
+
-`per_page`: Number of results per page (max 100, default: 30) (number, optional)
667
+
-`query`: Filter projects by a search query (matches title and description) (string, optional)
668
+
669
+
</details>
670
+
671
+
<details>
672
+
658
673
<summary>Pull Requests</summary>
659
674
660
675
-**add_comment_to_pending_review** - Add review comment to the requester's latest pending pull request review
| Repositories | GitHub Repository related tools |https://api.githubcopilot.com/mcp/x/repos|[Install](https://insiders.vscode.dev/redirect/mcp/install?name=gh-repos&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Frepos%22%7D)|[read-only](https://api.githubcopilot.com/mcp/x/repos/readonly)|[Install read-only](https://insiders.vscode.dev/redirect/mcp/install?name=gh-repos&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Frepos%2Freadonly%22%7D)|
34
35
| Secret Protection | Secret protection related tools, such as GitHub Secret Scanning |https://api.githubcopilot.com/mcp/x/secret_protection|[Install](https://insiders.vscode.dev/redirect/mcp/install?name=gh-secret_protection&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fsecret_protection%22%7D)|[read-only](https://api.githubcopilot.com/mcp/x/secret_protection/readonly)|[Install read-only](https://insiders.vscode.dev/redirect/mcp/install?name=gh-secret_protection&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2Fx%2Fsecret_protection%2Freadonly%22%7D)|
@@ -45,10 +46,45 @@ These toolsets are only available in the remote GitHub MCP Server and are not in
You can configure toolsets and readonly mode by providing HTTP headers in your server configuration.
51
+
The Remote GitHub MCP server has optional headers equivalent to the Local server env vars:
51
52
52
-
The headers are:
53
-
-`X-MCP-Toolsets=<toolset>,<toolset>...`
54
-
-`X-MCP-Readonly=true`
53
+
-`X-MCP-Toolsets`: Comma-separated list of toolsets to enable. E.g. "repos,issues".
54
+
- Equivalent to `GITHUB_TOOLSETS` env var for Local server.
55
+
- 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.
56
+
-`X-MCP-Readonly`: Enables only "read" tools.
57
+
- Equivalent to `GITHUB_READ_ONLY` env var for Local server.
58
+
- 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.
59
+
60
+
Example:
61
+
62
+
```json
63
+
{
64
+
"type": "http",
65
+
"url": "https://api.githubcopilot.com/mcp/",
66
+
"headers": {
67
+
"X-MCP-Toolsets": "repos,issues",
68
+
"X-MCP-Readonly": "true"
69
+
}
70
+
}
71
+
```
72
+
73
+
### URL Path Parameters
74
+
75
+
The Remote GitHub MCP server also supports the URL path parameters:
76
+
77
+
-`/x/{toolset}`
78
+
-`/x/{toolset}/readonly`
79
+
-`/readonly`
80
+
81
+
Note: `{toolset}` can only been a single toolset, not a comma-separated list. To combine multiple toolsets, use the `X-MCP-Toolsets` header instead.
"description": "List Projects for a user or organization",
7
+
"inputSchema": {
8
+
"properties": {
9
+
"after": {
10
+
"description": "Cursor for items after (forward pagination)",
11
+
"type": "string"
12
+
},
13
+
"before": {
14
+
"description": "Cursor for items before (backwards pagination)",
15
+
"type": "string"
16
+
},
17
+
"owner": {
18
+
"description": "If owner_type == user it is the handle for the GitHub user account. If owner_type == organization it is the name of the organization. The name is not case sensitive.",
19
+
"type": "string"
20
+
},
21
+
"owner_type": {
22
+
"description": "Owner type",
23
+
"enum": [
24
+
"user",
25
+
"organization"
26
+
],
27
+
"type": "string"
28
+
},
29
+
"per_page": {
30
+
"description": "Number of results per page (max 100, default: 30)",
31
+
"type": "number"
32
+
},
33
+
"query": {
34
+
"description": "Filter projects by a search query (matches title and description)",
0 commit comments