Update docs with better guidance for configuring additional toolsets

[rajbos]

Describe the bug

Currently the readme shown in the server config does not show anything about the options to configure additional toolsets. If you scroll over the remote section you end up finding the local server config for extra tools, which is confusing.

Even worse, the link to the "Remove Server Documentation" goes to https://raw.githubusercontent.com/github/github-mcp-server/main/docs/remote-server.md from the registry page, whereas it shows the normal url in the repo README itself.

Eventually you hope to find the actual documentation page here: https://github.com/github/github-mcp-server/blob/main/docs/remote-server.md

This page does not show the names of the toolsets you need to configure! The name here is the display name it seems, but you need to actually configure the key from the API URL, so code_security instead of Code Security.

I'd suggest fixing the naming thing first, and then look at the issue with the links.

[tommaso-moro]

Hi @rajbos thank you so much for reporting this!

Regarding the toolset names, they can be found in the official docs here: https://github.com/github/github-mcp-server?tab=readme-ov-file#available-toolsets listed out using their "true" names (not the display names)

However you're right to point out that it would be worth having them in the remote_server.md docs too! The links are also definitiely an issue: they work when viewing the docs in the official repo, but not through the MCP Registry. Thank you for raising this with us.

I will ensure we fix all this asap!

[sfosss]

/@copilot review #1744

[tommaso-moro]

Hi @rajbos just wanted to share an update on the above and confirm that we have fixed the broken links!

[gokhanarkan]

Hi @rajbos just wanted to share an update on the above and confirm that we have fixed the broken links!

beat me to it @tommaso-moro! I meant to tag you here but I underestimated your evening notifications game 😂