[mcp-tools-report] GitHub MCP Remote Server Tools Report — 2026-06-07

[github-actions[bot]]

Generated: 2026-06-07 · MCP Mode: Remote (read-only session) · Toolsets: All · Previous Report: 2026-05-31

Executive Summary

• Total Tools Discovered: 57 (read-only session)
• Toolset Categories: 20 (read-tool groupings)
• Source: github_toolsets_permissions.json · Instructions: github-mcp-server.md
• Changes Since Last Report: +1 new (list_issue_fields), 0 removed, 56 unchanged

Note: this read-only session exposes only read tools. Write tools (issue_write, create_pull_request, label_write, ...) exist in the server and remain in the JSON mapping but are not visible here.

Inconsistency Detection

✅ All tools are properly categorized with no detected duplicates, miscategorization, naming inconsistencies, or orphaned tools. Naming follows the expected verb_noun convention (e.g. list_*, get_*, search_*) and consolidated multi-method tools (issue_read, pull_request_read, actions_get, projects_get).

JSON Mapping Comparison

Summary — comparing the live MCP server against the JSON mapping:

• Total Discrepancies: 1
• Missing Tools (in JSON, not in MCP): 0 read tools (write tools omitted by design)
• Extra Tools (in MCP, not in JSON): 1
• Moved Tools: 0

Extra Tools (in MCP but not in JSON)

Toolset	Tool Name	Action Taken
issues	list_issue_fields	Added to JSON mapping

Action: Created pull request #aw_pr1 ([mcp-tools] Add list_issue_fields to issues toolset mapping) adding list_issue_fields to the issues toolset in alphabetical order.

Changes Since Last Report

New Tools Added ✨

Toolset	Tool Name	Purpose
issues	list_issue_fields	List issue field definitions (name, type — text/number/date/single_select — and valid option names) for a repo or org

Removed Tools 🗑️ · Moved Tools 🔄

None — no tools were removed or re-categorized since the last report.

Tools by Toolset

Core: context · repos · issues · pull_requests (click to expand)

repos Toolset — Repository operations

Source: repositories.go

Tool	Purpose	Key Params
get_commit	Commit details + diff	owner, repo, sha
get_file_contents	File/dir contents	owner, repo, path, ref
get_latest_release	Latest release	owner, repo
get_release_by_tag	Release by tag	owner, repo, tag
get_tag	Git tag details	owner, repo, tag
list_branches	List branches	owner, repo
list_commits	List commits	owner, repo, sha
list_releases	List releases	owner, repo
list_repository_collaborators	List collaborators	owner, repo, affiliation
list_tags	List git tags	owner, repo

issues Toolset — Issue management

Source: issues.go

Tool	Purpose	Key Params
issue_read	Read issue (get/comments/sub-issues/labels)	owner, repo, issue_number, method
list_issue_fields ✨	List custom field definitions	owner, repo
list_issue_types	Org issue types	owner
list_issues	List issues	owner, repo, state, labels
search_issues	Search issues (is:issue)	query

pull_requests Toolset — PR operations

Source: pullrequests.go

Tool	Purpose	Key Params
list_pull_requests	List PRs	owner, repo, state
pull_request_read	PR details (get/diff/status/files/reviews/comments/check_runs)	owner, repo, pullNumber, method
search_pull_requests	Search PRs (is:pr)	query

context toolset (get_me, get_teams, get_team_members) — identity/team tools in the mapping (context_tools.go).

Search & discovery: search · users · orgs · stargazers · gists · git (click to expand)

search Toolset — Source: search.go

Tool	Purpose
search_code	Code search across GitHub
search_commits	Commit-message search (default branch)
search_orgs	Find organizations
search_repositories	Find repositories
search_users	Find users
semantic_issue_similarity_search	Find issues similar to a given issue
semantic_issues_search	Natural-language issue search

orgs · gists · git · stargazers

Toolset	Tool	Purpose	Source
orgs	list_org_repository_security_advisories	Org repo advisories	security_advisories.go (orgs toolset)
gists	get_gist, list_gists	Gist read	gists.go
git	get_repository_tree	Repo tree at a ref	repositories.go
stargazers	list_starred_repositories	List starred repos	repositories.go

users toolset hosts search_users (see search.go).

Automation: actions · notifications · projects · discussions · labels (click to expand)

Toolset	Tool	Purpose	Source
actions	actions_get, actions_list, get_job_logs	Workflows/runs/jobs/artifacts + logs	actions.go
notifications	get_notification_details, list_notifications	Notification read	notifications.go
projects	projects_get, projects_list	Projects/fields/items/status	projects.go
discussions	get_discussion, get_discussion_comments, list_discussion_categories, list_discussions	Discussions read	discussions.go
labels	get_label, list_label	Label read	labels.go

Security: code_security · dependabot · secret_protection · security_advisories (click to expand)

Toolset	Tool	Purpose	Source
code_security	get_code_scanning_alert, list_code_scanning_alerts	Code scanning alerts	code_scanning.go
dependabot	get_dependabot_alert, list_dependabot_alerts	Dependabot alerts	dependabot.go
secret_protection	get_secret_scanning_alert, list_secret_scanning_alerts, run_secret_scanning	Secret scanning + content scan	secret_scanning.go
security_advisories	check_dependency_vulnerabilities, get_global_security_advisory, list_global_security_advisories, list_repository_security_advisories	Advisory DB + repo/global advisories	security_advisories.go

Remote-only: copilot_spaces · github_support_docs_search (click to expand)

Toolset	Tool	Purpose
copilot_spaces	get_copilot_space, list_copilot_spaces	Copilot Spaces read
github_support_docs_search	github_support_docs_search	GitHub support docs search

Recommended Default Toolsets

Recommended Defaults: context, repos, issues, pull_requests

Rationale:

• context — identity/team awareness (get_me, get_teams), essential for any GitHub-aware agent.
• repos — core file/commit/branch reads needed by most workflows.
• issues — read/comment/create, common in CI/CD and automation.
• pull_requests — read/create/review, critical for code-review and merge automation.

These match the current [default] set; no change recommended. The new list_issue_fields lands in the already-default issues toolset, so defaults stay current automatically.

Specialized (enable explicitly): actions (CI), discussions, the four security toolsets (audits), projects (requires PAT, not GITHUB_TOKEN), notifications, gists, labels, orgs, stargazers, users, and the remote-only copilot_spaces / github_support_docs_search.

Notes and Observations

• The single delta this cycle (list_issue_fields) reflects GitHub's rollout of custom issue field definitions; it complements list_issue_types and pairs with list_issues field filtering.
• ⚠️ Per the instructions file, do not use mode: remote in GitHub Actions — GITHUB_TOKEN lacks MCP access; default mode: local (Docker) should be used. This report enumerates the remote surface for documentation parity only.

Methodology

Self-inspection of mcp__github__* tools in the read-only remote session. Diff: baseline = cached 2026-05-31 (56 tools); current = 57 → added list_issue_fields. Mapping: github_toolsets_permissions.json · server source: github/github-mcp-server.

References:

• §27093080978

Generated by 📊 GitHub MCP Remote Server Tools Report Generator · 236.5 AIC · ⌖ 11.6 AIC · ⊞ 10.7K · ◷

• expires on Jun 10, 2026, 5:00 AM UTC-08:00