[mcp-tools-report] GitHub MCP Remote Server Tools Report — 2026-04-05

[github-actions[bot]]

Executive Summary

• Total Tools Discovered: 86
• Toolset Categories: 22
• Report Date: 2026-04-05
• Previous Report: None (first run with cache)
• Source: pkg/workflow/data/github_toolsets_permissions.json
• Instructions File: .github/aw/github-mcp-server.md
• Changes Since Last Report:
  • New Tools: 7 (first structured cache run — compared against JSON v2.1)
  • New Toolsets: 3 (git, copilot_spaces, github_support_docs_search)

Inconsistency Detection

Toolset Integrity Checks

• users toolset: Still empty — no tools registered. User search is available via search_users in the search toolset. This remains an intentional design choice per the MCP server source.
• search toolset vs toolset source: The search toolset (search_orgs, search_repositories, search_users) is defined primarily in search.go but search_users serves double duty with the empty users toolset. No functional duplication since users has no tools.
• Remote-only toolsets: copilot_spaces and github_support_docs_search are remote-only — they exist in the remote GitHub MCP server but have no local implementation in the open-source github/github-mcp-server repository.
• No naming inconsistencies detected across existing toolsets.

JSON Mapping Comparison

Discrepancies Between MCP Server and JSON Mapping (v2.1 → v2.2)

Summary:

• Total Discrepancies: 10
• Missing Tools (in JSON but not in MCP): 0
• Extra Tools (in MCP but not in JSON): 7 tools across 3 new toolsets + 2 existing toolsets
• Moved Tools: 0

Extra Tools (in MCP but not in JSON v2.1)

Toolset	Tool Name	Action Taken
git (new)	get_repository_tree	Added new git toolset
copilot_spaces (new)	get_copilot_space	Added new copilot_spaces toolset
copilot_spaces (new)	list_copilot_spaces	Added new copilot_spaces toolset
github_support_docs_search (new)	github_support_docs_search	Added new github_support_docs_search toolset
search	semantic_issue_similarity_search	Added to existing search toolset
search	semantic_issues_search	Added to existing search toolset
secret_protection	run_secret_scanning	Added to existing secret_protection toolset

Action: Pull request created with updated JSON mapping (v2.1 → v2.2). Documentation and cache updated on main.

Changes Since Last Report

This is the first run with the structured cache. Comparison was made against the previous JSON mapping (v2.1).

New Tools Added ✨

Toolset	Tool Name	Purpose
git	get_repository_tree	Get tree structure of a repository at any ref/SHA
copilot_spaces	get_copilot_space	Get context from a Copilot knowledge space
copilot_spaces	list_copilot_spaces	List accessible Copilot Spaces
github_support_docs_search	github_support_docs_search	Search GitHub product/support docs
search	semantic_issue_similarity_search	NLP-based issue similarity search
search	semantic_issues_search	Natural language issue search
secret_protection	run_secret_scanning	Scan file content for secrets/credentials

Tools by Toolset

View All 22 Toolsets (86 tools total)

actions (4 tools)

Source: pkg/github/actions.go

Tool	Purpose	Key Parameters
actions_get	Get details of specific Actions resources	owner, repo, resource_id, method
actions_list	List Actions resources (workflows, runs, jobs, artifacts)	owner, repo, method
actions_run_trigger	Trigger a workflow run	owner, repo, workflow_id, ref, inputs
get_job_logs	Get logs for workflow jobs	owner, repo, job_id or run_id

code_security (2 tools)

Source: pkg/github/code_scanning.go

Tool	Purpose	Key Parameters
get_code_scanning_alert	Get a specific code scanning alert	owner, repo, alertNumber
list_code_scanning_alerts	List code scanning alerts	owner, repo, state, severity

context (3 tools)

Source: pkg/github/context_tools.go

Tool	Purpose	Key Parameters
get_me	Get authenticated user details	—
get_team_members	List members of a GitHub team	org, team_slug
get_teams	List teams the authenticated user belongs to	org

copilot_spaces (2 tools) 🆕

Source: Remote-only (no local implementation in github-mcp-server)

Tool	Purpose	Key Parameters
get_copilot_space	Get context from a Copilot space	owner, name
list_copilot_spaces	List Copilot Spaces accessible to the user	—

dependabot (2 tools)

Source: pkg/github/dependabot.go

Tool	Purpose	Key Parameters
get_dependabot_alert	Get a specific Dependabot alert	owner, repo, alertNumber
list_dependabot_alerts	List Dependabot alerts	owner, repo, state, severity

discussions (4 tools)

Source: pkg/github/discussions.go

Tool	Purpose	Key Parameters
get_discussion	Get a specific discussion	owner, repo, discussionNumber
get_discussion_comments	Get comments from a discussion	owner, repo, discussionNumber
list_discussion_categories	List discussion categories	owner, repo
list_discussions	List discussions	owner, repo, category

experiments (3 tools)

Source: pkg/github/dynamic_tools.go

Tool	Purpose	Key Parameters
enable_toolset	Dynamically enable a toolset	toolset
get_toolset_tools	Get tools in a specific toolset	toolset
list_available_toolsets	List all available toolsets	—

gists (4 tools)

Source: pkg/github/gists.go

Tool	Purpose	Key Parameters
create_gist	Create a new gist	description, files, public
get_gist	Get a gist by ID	gist_id
list_gists	List gists for a user	username, page, perPage
update_gist	Update an existing gist	gist_id, description, files

git (1 tool) 🆕

Source: pkg/github/git.go

Tool	Purpose	Key Parameters
get_repository_tree	Get file/directory tree at a ref or SHA	owner, repo, tree_sha, recursive, path_filter

github_support_docs_search (1 tool) 🆕

Source: Remote-only (no local implementation in github-mcp-server)

Tool	Purpose	Key Parameters
github_support_docs_search	Search GitHub product/support documentation	query

issues (7 tools)

Source: pkg/github/issues.go

Tool	Purpose	Key Parameters
add_issue_comment	Add a comment to an issue	owner, repo, issue_number, body
issue_read	Read issue details, comments, sub-issues, labels	owner, repo, issue_number, method
issue_write	Create or update an issue	owner, repo, title, body
list_issue_types	List issue types for an organization	owner
list_issues	List issues in a repository	owner, repo, state, labels
search_issues	Search issues using GitHub search syntax	query, page, perPage
sub_issue_write	Create or manage sub-issues	owner, repo, issue_number

labels (3 tools)

Source: pkg/github/labels.go

Tool	Purpose	Key Parameters
get_label	Get a specific label	owner, repo, name
label_write	Create or update a label	owner, repo, name, color
list_label	List labels in a repository	owner, repo

notifications (6 tools)

Source: pkg/github/notifications.go

Tool	Purpose	Key Parameters
dismiss_notification	Dismiss a notification	notificationID
get_notification_details	Get details of a notification	notificationID
list_notifications	List GitHub notifications	filter, owner, repo
manage_notification_subscription	Manage thread subscription	thread_id, subscribed
manage_repository_notification_subscription	Manage repo notification subscription	owner, repo, subscribed
mark_all_notifications_read	Mark all notifications as read	last_read_at

orgs (1 tool)

Source: pkg/github/security_advisories.go

Tool	Purpose	Key Parameters
list_org_repository_security_advisories	List security advisories for an org	org, state

projects (3 tools)

Source: pkg/github/projects.go

Tool	Purpose	Key Parameters
projects_get	Get details about a project or project resources	owner, project_number, method
projects_list	List projects for a user or organization	owner, method
projects_write	Create or update project items/fields	owner, project_number, method

pull_requests (10 tools)

Source: pkg/github/pullrequests.go

Tool	Purpose	Key Parameters
add_comment_to_pending_review	Add comment to pending review	owner, repo, pull_number
add_reply_to_pull_request_comment	Reply to a PR review comment	owner, repo, pull_number, comment_id, body
create_pull_request	Create a new pull request	owner, repo, title, head, base
list_pull_requests	List pull requests	owner, repo, state
merge_pull_request	Merge a pull request	owner, repo, pullNumber, merge_method
pull_request_read	Read PR details, diff, files, reviews, comments	owner, repo, pullNumber, method
pull_request_review_write	Create or submit a PR review	owner, repo, pullNumber
search_pull_requests	Search PRs using GitHub search syntax	query, page, perPage
update_pull_request	Update PR title, body, or state	owner, repo, pullNumber
update_pull_request_branch	Update PR branch with latest base	owner, repo, pullNumber

repos (15 tools)

Source: pkg/github/repositories.go

Tool	Purpose	Key Parameters
create_branch	Create a new branch	owner, repo, branch
create_or_update_file	Create or update a file	owner, repo, path, content, message
create_repository	Create a new repository	name, description, private
delete_file	Delete a file	owner, repo, path, sha, message
fork_repository	Fork a repository	owner, repo
get_commit	Get commit details	owner, repo, sha
get_file_contents	Read file or directory contents	owner, repo, path, ref
get_latest_release	Get latest release	owner, repo
get_release_by_tag	Get release by tag	owner, repo, tag
get_tag	Get details of a tag	owner, repo, tag
list_branches	List branches	owner, repo
list_commits	List commits	owner, repo, sha
list_releases	List releases	owner, repo
list_tags	List tags	owner, repo
push_files	Push multiple files in one commit	owner, repo, branch, files, message

search (6 tools, +2 new)

Source: pkg/github/search.go

Tool	Purpose	Key Parameters
search_code	Search code across GitHub repositories	query, page, perPage
search_orgs	Find organizations by name/location	query, page, perPage
search_repositories	Find repositories by name/topic/metadata	query, page, perPage
search_users	Find users by name/profile info	query, page, perPage
semantic_issue_similarity_search 🆕	NLP-based issue similarity (finds duplicates/related)	owner, repo, issue_number, threshold, per_page
semantic_issues_search 🆕	Natural language issue search across repos	query, owner, repo

secret_protection (3 tools, +1 new)

Source: pkg/github/secret_scanning.go

Tool	Purpose	Key Parameters
get_secret_scanning_alert	Get a specific secret scanning alert	owner, repo, alertNumber
list_secret_scanning_alerts	List secret scanning alerts	owner, repo, state
run_secret_scanning 🆕	Scan file content/diffs for secrets	files, owner, repo

security_advisories (3 tools)

Source: pkg/github/security_advisories.go

Tool	Purpose	Key Parameters
get_global_security_advisory	Get a global advisory by GHSA ID	ghsaId
list_global_security_advisories	List advisories from the Advisory Database	severity, ecosystem, type
list_repository_security_advisories	List advisories for a repository	owner, repo, state

stargazers (3 tools)

Source: pkg/github/repositories.go

Tool	Purpose	Key Parameters
list_starred_repositories	List starred repositories	username, page, perPage
star_repository	Star a repository	owner, repo
unstar_repository	Unstar a repository	owner, repo

users (0 tools)

No tools registered. User search is available via search_users in the search toolset.

Recommended Default Toolsets

Toolset	Rationale
context	Identity and team awareness — essential for any GitHub-aware agent
repos	Core repository operations (read files, commits, branches)
issues	Issue management (read, comment, create) — most common CI/CD use case
pull_requests	PR operations (read, create, review) — critical for code automation

Specialized toolsets (enable explicitly when needed): actions, code_security, copilot_spaces, dependabot, discussions, experiments, gists, git, github_support_docs_search, labels, notifications, orgs, projects, search, secret_protection, security_advisories, stargazers

Toolset Configuration Reference

tools:
  github:
    mode: "remote"  # or "local" (default for GitHub Actions)
    toolsets: [default]  # context, repos, issues, pull_requests

Available options: context, repos, issues, pull_requests, actions, code_security, copilot_spaces, dependabot, discussions, experiments, gists, git, github_support_docs_search, labels, notifications, orgs, projects, search, secret_protection, security_advisories, stargazers, users, all

Notes and Observations

1. Three new remote-only toolsets found in the remote GitHub MCP server that are not in the open-source github/github-mcp-server repository: copilot_spaces, github_support_docs_search, and the semantic_* search tools in search.
2. git is a new dedicated toolset (get_repository_tree) separate from repos — it was defined in pkg/github/git.go but missing from the JSON mapping.
3. run_secret_scanning adds proactive secret detection capability to the secret_protection toolset (complementing the existing reactive alert-listing tools).
4. Semantic search tools represent AI/NLP-enhanced discovery: semantic_issue_similarity_search is ideal for de-duplication workflows; semantic_issues_search enables natural language queries across repositories.
5. users toolset remains empty by design — user search is routed through the search toolset's search_users tool.

Methodology

• Discovery Method: Self-inspection of available mcp__github__* tools in GitHub MCP remote server (all toolsets enabled, read-only mode)
• MCP Configuration: Remote mode with all toolsets enabled
• Source Verification: Cross-referenced against github/github-mcp-server source files
• JSON Mapping: pkg/workflow/data/github_toolsets_permissions.json
• Instructions: .github/aw/github-mcp-server.md

References:

• §24001581584

Generated by GitHub MCP Remote Server Tools Report Generator · ● 648.2K · ◷

• expires on Apr 8, 2026, 12:42 PM UTC

[github-actions[bot]]

This discussion was automatically closed because it expired on 2026-04-08T12:42:15.828Z.

Closed by Workflow