docs/remote-server.md

Remote GitHub MCP Server 🚀

Easily connect to the GitHub MCP Server using the hosted version – no local setup or runtime required.

URL: https://api.githubcopilot.com/mcp/

About

The remote GitHub MCP server is built using this repository as a library, and binding it into GitHub server infrastructure with an internal repository. You can open issues and propose changes in this repository, and we regularly update the remote server to include the latest version of this code.

The remote server has additional tools that are not available in the local MCP server, such as the create_pull_request_with_copilot tool for invoking Copilot coding agent.

Remote MCP Toolsets

Below is a table of available toolsets for the remote GitHub MCP Server. Each toolset is provided as a distinct URL so you can mix and match to create the perfect combination of tools for your use-case. Add /readonly to the end of any URL to restrict the tools in the toolset to only those that enable read access. We also provide the option to use headers instead.

Name	Description	API URL	1-Click Install (VS Code)	Read-only Link	1-Click Read-only Install (VS Code)
all	All available GitHub MCP tools	https://api.githubcopilot.com/mcp/	Install	read-only	Install read-only
Actions	GitHub Actions workflows and CI/CD operations	https://api.githubcopilot.com/mcp/x/actions	Install	read-only	Install read-only
Code Security	Code security related tools, such as GitHub Code Scanning	https://api.githubcopilot.com/mcp/x/code_security	Install	read-only	Install read-only
Dependabot	Dependabot tools	https://api.githubcopilot.com/mcp/x/dependabot	Install	read-only	Install read-only
Discussions	GitHub Discussions related tools	https://api.githubcopilot.com/mcp/x/discussions	Install	read-only	Install read-only
Experiments	Experimental features that are not considered stable yet	https://api.githubcopilot.com/mcp/x/experiments	Install	read-only	Install read-only
Gists	GitHub Gist related tools	https://api.githubcopilot.com/mcp/x/gists	Install	read-only	Install read-only
Issues	GitHub Issues related tools	https://api.githubcopilot.com/mcp/x/issues	Install	read-only	Install read-only
Notifications	GitHub Notifications related tools	https://api.githubcopilot.com/mcp/x/notifications	Install	read-only	Install read-only
Organizations	GitHub Organization related tools	https://api.githubcopilot.com/mcp/x/orgs	Install	read-only	Install read-only
Pull Requests	GitHub Pull Request related tools	https://api.githubcopilot.com/mcp/x/pull_requests	Install	read-only	Install read-only
Repositories	GitHub Repository related tools	https://api.githubcopilot.com/mcp/x/repos	Install	read-only	Install read-only
Secret Protection	Secret protection related tools, such as GitHub Secret Scanning	https://api.githubcopilot.com/mcp/x/secret_protection	Install	read-only	Install read-only
Security Advisories	Security advisories related tools	https://api.githubcopilot.com/mcp/x/security_advisories	Install	read-only	Install read-only
Users	GitHub User related tools	https://api.githubcopilot.com/mcp/x/users	Install	read-only	Install read-only

Additional Remote Server Toolsets

These toolsets are only available in the remote GitHub MCP Server and are not included in the local MCP server.

Name	Description	API URL	1-Click Install (VS Code)	Read-only Link	1-Click Read-only Install (VS Code)
Copilot coding agent	Perform task with GitHub Copilot coding agent	https://api.githubcopilot.com/mcp/x/copilot	Install	read-only	Install read-only

Headers

You can configure toolsets and readonly mode by providing HTTP headers in your server configuration.

The headers are:

• X-MCP-Toolsets=<toolset>,<toolset>...
• X-MCP-Readonly=true