diff --git a/README.md b/README.md
index 207c2b05f..d3220f2e6 100644
--- a/README.md
+++ b/README.md
@@ -98,6 +98,49 @@ See [Remote Server Documentation](docs/remote-server.md) for full details on rem
When no toolsets are specified, [default toolsets](#default-toolset) are used.
+#### Insiders Mode
+
+> **Try new features early!** The remote server offers an insiders version with early access to new features and experimental tools.
+
+
+| Using URL Path | Using Header |
+
+|
+
+```json
+{
+ "servers": {
+ "github": {
+ "type": "http",
+ "url": "https://api.githubcopilot.com/mcp/insiders"
+ }
+ }
+}
+```
+
+ |
+
+
+```json
+{
+ "servers": {
+ "github": {
+ "type": "http",
+ "url": "https://api.githubcopilot.com/mcp/",
+ "headers": {
+ "X-MCP-Insiders": "true"
+ }
+ }
+ }
+}
+```
+
+ |
+
+
+
+See [Remote Server Documentation](docs/remote-server.md#insiders-mode) for more details and examples.
+
#### GitHub Enterprise
##### GitHub Enterprise Cloud with data residency (ghe.com)
@@ -480,6 +523,31 @@ To keep the default configuration and add additional toolsets:
GITHUB_TOOLSETS="default,stargazers" ./github-mcp-server
```
+### Insiders Mode
+
+The local GitHub MCP Server offers an insiders version with early access to new features and experimental tools.
+
+1. **Using Command Line Argument**:
+
+ ```bash
+ ./github-mcp-server --insider-mode
+ ```
+
+2. **Using Environment Variable**:
+
+ ```bash
+ GITHUB_INSIDER_MODE=true ./github-mcp-server
+ ```
+
+When using Docker:
+
+```bash
+docker run -i --rm \
+ -e GITHUB_PERSONAL_ACCESS_TOKEN= \
+ -e GITHUB_INSIDER_MODE=true \
+ ghcr.io/github/github-mcp-server
+```
+
### Available Toolsets
The following sets of tools are available:
diff --git a/docs/remote-server.md b/docs/remote-server.md
index 039d094fe..b305271cf 100644
--- a/docs/remote-server.md
+++ b/docs/remote-server.md
@@ -67,6 +67,9 @@ The Remote GitHub MCP server has optional headers equivalent to the Local server
- `X-MCP-Lockdown`: Enables lockdown mode, hiding public issue details created by users without push access.
- Equivalent to `GITHUB_LOCKDOWN_MODE` env var for Local server.
- 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.
+- `X-MCP-Insiders`: Enables insiders mode for early access to new features.
+ - Equivalent to `GITHUB_INSIDER_MODE` env var or `--insider-mode` flag for Local server.
+ - 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.
> **Looking for examples?** See the [Server Configuration Guide](./server-configuration.md) for common recipes like minimal setups, read-only mode, and combining tools with toolsets.
@@ -84,18 +87,49 @@ Example:
}
```
+### Insiders Mode
+
+The remote GitHub MCP Server offers an insiders version with early access to new features and experimental tools. You can enable insiders mode in two ways:
+
+1. **Via URL path** - Append `/insiders` to the URL:
+
+ ```json
+ {
+ "type": "http",
+ "url": "https://api.githubcopilot.com/mcp/insiders"
+ }
+ ```
+
+2. **Via header** - Set the `X-MCP-Insiders` header to `true`:
+
+ ```json
+ {
+ "type": "http",
+ "url": "https://api.githubcopilot.com/mcp/",
+ "headers": {
+ "X-MCP-Insiders": "true"
+ }
+ }
+ ```
+
+Both methods can be combined with other path modifiers (like `/readonly`) and headers.
+
### URL Path Parameters
The Remote GitHub MCP server supports the following URL path patterns:
- `/` - Default toolset (see ["default" toolset](../README.md#default-toolset))
- `/readonly` - Default toolset in read-only mode
+- `/insiders` - Default toolset with insiders mode enabled
+- `/insiders/readonly` - Default toolset with insiders mode in read-only mode
- `/x/all` - All available toolsets
- `/x/all/readonly` - All available toolsets in read-only mode
+- `/x/all/insiders` - All available toolsets with insiders mode enabled
- `/x/{toolset}` - Single specific toolset
- `/x/{toolset}/readonly` - Single specific toolset in read-only mode
+- `/x/{toolset}/insiders` - Single specific toolset with insiders mode enabled
-Note: `{toolset}` can only be a single toolset, not a comma-separated list. To combine multiple toolsets, use the `X-MCP-Toolsets` header instead.
+Note: `{toolset}` can only be a single toolset, not a comma-separated list. To combine multiple toolsets, use the `X-MCP-Toolsets` header instead. Path modifiers like `/readonly` and `/insiders` can be combined with the `X-MCP-Insiders` or `X-MCP-Readonly` headers.
Example: