GitHub MCP Remote Server Tools Report — 2026-03-22

[github-actions[bot]]

Generated: 2026-03-22
MCP Mode: Remote
Toolsets: All
Previous Report: None (first run)

Executive Summary

• Total Tools Discovered: 79
• Toolset Categories: 19 (including search; users toolset is registered but empty)
• Report Date: 2026-03-22
• Source: pkg/workflow/data/github_toolsets_permissions.json
• Instructions File: .github/aw/github-mcp-server.md
• Changes Since Last Report: N/A — first run, no previous data

---

Inconsistency Detection

Toolset Integrity Checks

✅ All tools are properly categorized with no detected inconsistencies.

Notes:

• users toolset is registered but contains 0 tools. User search is available via the search toolset (search_users).
• search toolset is a 19th toolset (the mission brief listed 18), confirmed present in both the JSON mapping and source code.
• list_org_repository_security_advisories lives in security_advisories.go but is assigned to the orgs toolset — this is intentional and documented.

---

JSON Mapping Comparison

Discrepancies Between MCP Server and JSON Mapping

✅ JSON mapping is accurate and matches the MCP server.

Summary:

• Total Discrepancies: 0
• Missing Tools (in JSON but not in MCP): 0
• Extra Tools (in MCP but not in JSON): 0
• Moved Tools (different toolset): 0

Action: No updates needed — pkg/workflow/data/github_toolsets_permissions.json is accurate.

---

Changes Since Last Report

No previous report exists. This is the baseline run.

---

Tools by Toolset

context (3 tools) — GitHub context and environment

Source: pkg/github/context_tools.go

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

repos (15 tools) — Repository operations

Source: pkg/github/repositories.go

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

issues (7 tools) — Issue management

Source: pkg/github/issues.go

Tool Name	Purpose	Key Parameters
add_issue_comment	Add a comment to an issue	owner, repo, issue_number, body
issue_read	Read issue details and comments	owner, repo, issue_number
issue_write	Create or update an issue	owner, repo, title, body, labels, assignees
list_issue_types	List available issue types for a repository	owner, repo
list_issues	List issues in a repository	owner, repo, state, labels, page
search_issues	Search issues across GitHub	query, page, per_page
sub_issue_write	Create or manage sub-issues	owner, repo, issue_number

pull_requests (10 tools) — Pull request operations

Source: pkg/github/pullrequests.go

Tool Name	Purpose	Key Parameters
add_comment_to_pending_review	Add a comment to a pending PR review	owner, repo, pull_number, review_id
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, body, head, base
list_pull_requests	List pull requests in a repository	owner, repo, state, head, base
merge_pull_request	Merge a pull request	owner, repo, pull_number, merge_method
pull_request_read	Read PR details, reviews, and comments	owner, repo, pull_number
pull_request_review_write	Create or submit a PR review	owner, repo, pull_number, event, body
search_pull_requests	Search pull requests across GitHub	query, page, per_page
update_pull_request	Update PR title, body, or state	owner, repo, pull_number, title, body
update_pull_request_branch	Update PR branch with latest base	owner, repo, pull_number

actions (4 tools) — GitHub Actions workflows

Source: pkg/github/actions.go

Tool Name	Purpose	Key Parameters
actions_get	Get details of a specific workflow run	owner, repo, run_id
actions_list	List GitHub Actions workflows and runs	owner, repo, workflow_id
actions_run_trigger	Trigger a workflow run	owner, repo, workflow_id, ref, inputs
get_job_logs	Download logs for a specific workflow job	owner, repo, job_id

code_security (2 tools) — Code scanning alerts

Source: pkg/github/code_scanning.go

Tool Name	Purpose	Key Parameters
get_code_scanning_alert	Get details of a specific code scanning alert	owner, repo, alert_number
list_code_scanning_alerts	List code scanning alerts for a repository	owner, repo, state, severity

dependabot (2 tools) — Dependabot alerts

Source: pkg/github/dependabot.go

Tool Name	Purpose	Key Parameters
get_dependabot_alert	Get details of a specific Dependabot alert	owner, repo, alert_number
list_dependabot_alerts	List Dependabot alerts for a repository	owner, repo, state, severity

discussions (4 tools) — GitHub Discussions

Source: pkg/github/discussions.go

Tool Name	Purpose	Key Parameters
get_discussion	Get details of a specific discussion	owner, repo, discussion_number
get_discussion_comments	Get comments for a specific discussion	owner, repo, discussion_number
list_discussion_categories	List discussion categories for a repository	owner, repo
list_discussions	List discussions in a repository	owner, repo, category_id

experiments (3 tools) — Experimental / dynamic toolset management

Source: pkg/github/dynamic_tools.go

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

gists (4 tools) — Gist operations

Source: pkg/github/gists.go

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

labels (3 tools) — Label management

Source: pkg/github/labels.go

Tool Name	Purpose	Key Parameters
get_label	Get details of a specific label	owner, repo, name
label_write	Create or update a label	owner, repo, name, color, description
list_label	List labels in a repository	owner, repo, page, per_page

notifications (6 tools) — Notification management

Source: pkg/github/notifications.go

Tool Name	Purpose	Key Parameters
dismiss_notification	Dismiss a specific notification	notification_id
get_notification_details	Get details of a specific notification	notification_id
list_notifications	List user notifications	all, participating, page
manage_notification_subscription	Manage notification subscription for a thread	thread_id, subscribed
manage_repository_notification_subscription	Manage notifications for a repository	owner, repo, subscribed
mark_all_notifications_read	Mark all notifications as read	last_read_at

orgs (1 tool) — Organization operations

Source: pkg/github/security_advisories.go (tool defined here, assigned to orgs toolset)

Tool Name	Purpose	Key Parameters
list_org_repository_security_advisories	List security advisories for all repos in an org	org, state

projects (3 tools) — GitHub Projects

Source: pkg/github/projects.go

Note: Requires a PAT with project scope — not supported by GITHUB_TOKEN.

Tool Name	Purpose	Key Parameters
projects_get	Get details of a specific project	owner, project_number
projects_list	List GitHub Projects for a user or organization	owner, per_page
projects_write	Create or update project items/fields	owner, project_number

search (4 tools) — Advanced search across GitHub

Source: pkg/github/search.go

Tool Name	Purpose	Key Parameters
search_code	Search code across repositories	query, page, per_page
search_orgs	Search GitHub organizations	query, page, per_page
search_repositories	Search for repositories	query, page, per_page
search_users	Search GitHub users	query, page, per_page

secret_protection (2 tools) — Secret scanning

Source: pkg/github/secret_scanning.go

Tool Name	Purpose	Key Parameters
get_secret_scanning_alert	Get details of a specific secret scanning alert	owner, repo, alert_number
list_secret_scanning_alerts	List secret scanning alerts for a repository	owner, repo, state

security_advisories (3 tools) — Security advisories

Source: pkg/github/security_advisories.go

Tool Name	Purpose	Key Parameters
get_global_security_advisory	Get a specific global security advisory	ghsa_id
list_global_security_advisories	List advisories from the GitHub Advisory Database	type, severity, ecosystem
list_repository_security_advisories	List security advisories for a specific repository	owner, repo, state

stargazers (3 tools) — Repository stars

Source: pkg/github/repositories.go

Tool Name	Purpose	Key Parameters
list_starred_repositories	List repositories starred by a user	username, page, per_page
star_repository	Star a repository	owner, repo
unstar_repository	Unstar a repository	owner, repo

users (0 tools) — User information

Source: N/A (no tools registered)

The users toolset is registered in the JSON mapping and source code but contains no tools. User search is available via search_users in the search toolset.

---

Tool Count Summary

Toolset	Tool Count
actions	4
code_security	2
context	3
dependabot	2
discussions	4
experiments	3
gists	4
issues	7
labels	3
notifications	6
orgs	1
projects	3
pull_requests	10
repos	15
search	4
secret_protection	2
security_advisories	3
stargazers	3
users	0
Total	79

---

Recommended Default Toolsets

Recommended Defaults: context, repos, issues, pull_requests

Rationale:

• context — Identity and team awareness (get_me, get_teams) — essential for any GitHub-aware agent
• repos — Core repository operations (read files, list commits/branches) — most workflows need file access
• issues — Issue management (read, comment, create) — common in CI/CD and automation workflows
• pull_requests — PR operations (read, create, review) — critical for code review and merge automation

users is intentionally excluded from defaults: the toolset has no tools, and user search is already available via search_users in the search toolset.

Specialized Toolsets (enable explicitly when needed):

Toolset	When to Enable
actions	Workflow introspection, triggering runs
code_security	Code scanning alert management
dependabot	Dependency vulnerability management
discussions	Community discussion workflows
experiments	Dynamic toolset management
gists	Gist creation and management
labels	Label management automation
notifications	Notification processing agents
orgs	Organization-level security advisories
projects	GitHub Projects automation (requires PAT)
search	Cross-repository search operations
secret_protection	Secret scanning alert management
security_advisories	Advisory database queries
stargazers	Star/unstar repository operations
users	(currently empty — no tools registered)

---

Toolset Configuration Reference

tools:
  github:
    mode: "remote"  # or "local"
    toolsets: [default]  # context, repos, issues, pull_requests
    # To extend defaults:
    # toolsets: [default, discussions, actions]
    # To enable everything:
    # toolsets: [all]

---

Notes and Observations

• The search toolset is a 19th toolset not listed in some internal documentation that listed only 18. It is fully functional and present in both source code and the JSON mapping.
• list_org_repository_security_advisories is defined in security_advisories.go but assigned to the orgs toolset — a deliberate design choice, cross-referenced in the documentation.
• The repos toolset (15 tools) is the largest single-purpose toolset. The pull_requests toolset (10 tools) is the second largest.
• Mixed naming conventions exist across the server: some tools use verb-first snake_case (create_pull_request, search_code) while others use noun-first grouping (pull_request_read, issue_write, projects_list). This is intentional for grouping related read/write variants.

---

Methodology

• Discovery Method: Cross-reference of available MCP tools via GitHub MCP remote server + source code inspection of github/github-mcp-server
• MCP Configuration: Remote mode with all toolsets enabled
• Categorization: Based on toolset assignments in source registration code
• JSON Mapping: pkg/workflow/data/github_toolsets_permissions.json
• Instructions: .github/aw/github-mcp-server.md
• MCP Server Source: github/github-mcp-server

References: §23403114941

AI generated by GitHub MCP Remote Server Tools Report Generator · history

• expires on Mar 29, 2026, 12:38 PM UTC

[github-actions[bot]]

This discussion was automatically closed because it expired on 2026-03-29T12:38:01.102Z.

Closed by Workflow