Compare scopes

[JoannaaKL]

Summary

Just add a script to extract scopes from a token.

Why

Fixes #

What changed

• Added a script to extract scopes from a PAT

MCP impact

• No tool or API changes
• Tool schema or behavior changed
• New tool added

Prompts tested (tool changes only)

Security / limits

• No security or limits impact
• Auth / permissions considered
• Data exposure, filtering, or token/size limits considered

Tool renaming

• I am renaming tools as part of this PR (e.g. a part of a consolidation effort)
  • I have added the new tool aliases in deprecated_tool_aliases.go
• I am not renaming tools as part of this PR

Note: if you're renaming tools, you must add the tool aliases. For more information on how to do so, please refer to the official docs.

Lint & tests

• Linted locally with ./script/lint
• Tested locally with ./script/test

Docs

• Not needed
• Updated (README / docs / examples)

[Copilot]

Pull request overview

This PR adds utilities for inspecting and comparing OAuth scopes for GitHub Personal Access Tokens (PATs). It introduces two bash scripts and a new Go command to help users understand what scopes are required for MCP server tools and what scopes their tokens have.

Key changes:

• Added script/get-token-scopes to extract OAuth scopes from a PAT via GitHub API
• Added script/list-scopes wrapper for the new list-scopes Go command
• Added list-scopes subcommand to list required scopes for enabled tools with text/json/summary output formats
• Refactored formatToolsetName function to shared helpers.go file for reuse

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
script/list-scopes	Bash wrapper that builds and executes the list-scopes Go command
script/get-token-scopes	Bash script to fetch OAuth scopes from a PAT using the GitHub API
cmd/github-mcp-server/list_scopes.go	Implementation of the list-scopes command with multiple output formats
cmd/github-mcp-server/helpers.go	Extracted shared helper function formatToolsetName for reuse
cmd/github-mcp-server/generate_docs.go	Removed duplicate formatToolsetName function (now in helpers.go)