GitHub MCP Remote Server Tools Report

2025-10-12T03:07:39Z

github-actions[bot]
bot Oct 12, 2025

Generated: October 12, 2025
MCP Mode: Remote
Toolsets: All
Previous Report: None (First Run)

Executive Summary

Total Tools Discovered: 103
Toolset Categories: 16
Report Date: October 12, 2025
Changes Since Last Report: N/A (First baseline report)

Overview

This is the first comprehensive inventory of all tools available in the GitHub MCP Remote Server. This baseline report documents all 103 tools across 16 functional toolsets, providing developers with a complete reference for integrating GitHub operations into agentic workflows.

Tools by Toolset

Pull Requests Toolset (14 tools)

Comprehensive pull request operations including creation, review, merging, and status management.

Tool Name	Purpose	Key Parameters
`add_comment_to_pending_review`	Add review comment to the requester's latest pending pull request review	owner, repo, pullNumber, path, body, subjectType
`create_and_submit_pull_request_review`	Create and submit a review for a pull request without review comments	owner, repo, pullNumber, body, event
`create_pending_pull_request_review`	Create a pending review for a pull request before adding comments	owner, repo, pullNumber, commitID (optional)
`create_pull_request`	Create a new pull request in a GitHub repository	owner, repo, title, head, base, body (optional)
`create_pull_request_with_copilot`	Delegate a task to GitHub Copilot coding agent to create a pull request with implementation	owner, repo, problem_statement, title, base_ref (optional)
`delete_pending_pull_request_review`	Delete the requester's latest pending pull request review	owner, repo, pullNumber
`list_pull_requests`	List pull requests in a GitHub repository	owner, repo, state (optional), page, perPage
`merge_pull_request`	Merge a pull request in a GitHub repository	owner, repo, pullNumber, merge_method (optional)
`pull_request_read`	Get information on a specific pull request (details, diff, status, files, review comments, reviews)	method, owner, repo, pullNumber, page, perPage
`request_copilot_review`	Request a GitHub Copilot code review for a pull request	owner, repo, pullNumber
`search_pull_requests`	Search for pull requests in GitHub repositories using issues search syntax	query, owner (optional), repo (optional), sort, order
`submit_pending_pull_request_review`	Submit the requester's latest pending pull request review	owner, repo, pullNumber, event, body (optional)
`update_pull_request`	Update an existing pull request in a GitHub repository	owner, repo, pullNumber, title/body/state/draft (optional)
`update_pull_request_branch`	Update the branch of a pull request with the latest changes from the base branch	owner, repo, pullNumber, expectedHeadSha (optional)

Issues Toolset (13 tools)

Complete issue management including creation, updates, comments, and sub-issue tracking.

Tool Name	Purpose	Key Parameters
`add_issue_comment`	Add a comment to a specific issue in a GitHub repository	owner, repo, issue_number, body
`add_sub_issue`	Add a sub-issue to a parent issue in a GitHub repository	owner, repo, issue_number, sub_issue_id, replace_parent (optional)
`assign_copilot_to_issue`	Assign Copilot to a specific issue to create a Pull Request with source code changes	owner, repo, issueNumber
`create_issue`	Create a new issue in a GitHub repository	owner, repo, title, body (optional), labels, assignees
`get_issue`	Get details of a specific issue in a GitHub repository	owner, repo, issue_number
`get_issue_comments`	Get comments for a specific issue in a GitHub repository	owner, repo, issue_number, page, perPage
`list_issue_types`	List supported issue types for repository owner (organization)	owner
`list_issues`	List issues in a GitHub repository with filtering and pagination	owner, repo, state, labels, after, perPage
`list_sub_issues`	List sub-issues for a specific issue in a GitHub repository	owner, repo, issue_number, page, per_page
`remove_sub_issue`	Remove a sub-issue from a parent issue in a GitHub repository	owner, repo, issue_number, sub_issue_id
`reprioritize_sub_issue`	Reprioritize a sub-issue to a different position in the parent issue's sub-issue list	owner, repo, issue_number, sub_issue_id, after_id/before_id
`search_issues`	Search for issues in GitHub repositories using issues search syntax	query, owner (optional), repo (optional), sort, order
`update_issue`	Update an existing issue in a GitHub repository	owner, repo, issue_number, title/body/state/labels/assignees (optional)

Repositories Toolset (17 tools)

Repository operations including file management, branches, commits, and search capabilities.

Tool Name	Purpose	Key Parameters
`create_branch`	Create a new branch in a GitHub repository	owner, repo, branch, from_branch (optional)
`create_or_update_file`	Create or update a single file in a GitHub repository remotely	owner, repo, path, content, message, branch, sha (optional)
`create_repository`	Create a new GitHub repository in your account or specified organization	name, description (optional), private, autoInit, organization (optional)
`delete_file`	Delete a file from a GitHub repository	owner, repo, path, message, branch
`fork_repository`	Fork a GitHub repository to your account or specified organization	owner, repo, organization (optional)
`get_commit`	Get details for a commit from a GitHub repository	owner, repo, sha, include_diff, page, perPage
`get_file_contents`	Get the contents of a file or directory from a GitHub repository	owner, repo, path, ref (optional), sha (optional)
`get_tag`	Get details about a specific git tag in a GitHub repository	owner, repo, tag
`list_branches`	List branches in a GitHub repository	owner, repo, page, perPage
`list_commits`	Get list of commits of a branch in a GitHub repository	owner, repo, sha (optional), author, page, perPage
`list_tags`	List git tags in a GitHub repository	owner, repo, page, perPage
`push_files`	Push multiple files to a GitHub repository in a single commit	owner, repo, branch, files, message
`search_code`	Fast and precise code search across ALL GitHub repositories using GitHub's native search engine	query, sort, order, page, perPage
`search_repositories`	Find GitHub repositories by name, description, readme, topics, or other metadata	query, sort, order, minimal_output, page, perPage
`semantic_code_search`	Search for code, documentation, and other content using natural language queries within a single GitHub Repository	owner, repo, prompt
`star_repository`	Star a GitHub repository	owner, repo
`unstar_repository`	Unstar a GitHub repository	owner, repo

GitHub Actions Toolset (14 tools)

Workflow management including run control, log access, and artifact handling.

Tool Name	Purpose	Key Parameters
`cancel_workflow_run`	Cancel a workflow run	owner, repo, run_id
`delete_workflow_run_logs`	Delete logs for a workflow run	owner, repo, run_id
`download_workflow_run_artifact`	Get download URL for a workflow run artifact	owner, repo, artifact_id
`get_job_logs`	Download logs for a specific workflow job or get all failed job logs for a workflow run	owner, repo, job_id (optional), run_id (optional), failed_only, return_content, tail_lines
`get_workflow_run`	Get details of a specific workflow run	owner, repo, run_id
`get_workflow_run_logs`	Download logs for a specific workflow run (EXPENSIVE: downloads ALL logs as ZIP)	owner, repo, run_id
`get_workflow_run_usage`	Get usage metrics for a workflow run	owner, repo, run_id
`list_workflow_jobs`	List jobs for a specific workflow run	owner, repo, run_id, filter, page, perPage
`list_workflow_run_artifacts`	List artifacts for a workflow run	owner, repo, run_id, page, perPage
`list_workflow_runs`	List workflow runs for a specific workflow	owner, repo, workflow_id, actor, branch, event, status, page, perPage
`list_workflows`	List workflows in a repository	owner, repo, page, perPage
`rerun_failed_jobs`	Re-run only the failed jobs in a workflow run	owner, repo, run_id
`rerun_workflow_run`	Re-run an entire workflow run	owner, repo, run_id
`run_workflow`	Run an Actions workflow by workflow ID or filename	owner, repo, workflow_id, ref, inputs (optional)

Notifications Toolset (6 tools)

Comprehensive notification management for staying updated on GitHub activity.

Tool Name	Purpose	Key Parameters
`dismiss_notification`	Dismiss a notification by marking it as read or done	threadID, state
`get_notification_details`	Get detailed information for a specific GitHub notification	notificationID
`list_notifications`	Lists all GitHub notifications for the authenticated user including unread, mentions, and review requests	filter, since, before, owner (optional), repo (optional), page, perPage
`manage_notification_subscription`	Manage a notification subscription: ignore, watch, or delete a notification thread subscription	notificationID, action
`manage_repository_notification_subscription`	Manage a repository notification subscription: ignore, watch, or delete repository notifications	owner, repo, action
`mark_all_notifications_read`	Mark all notifications as read	lastReadAt (optional), owner (optional), repo (optional)

Discussions Toolset (4 tools)

GitHub Discussions operations for community engagement and conversations.

Tool Name	Purpose	Key Parameters
`get_discussion`	Get a specific discussion by ID	owner, repo, discussionNumber
`get_discussion_comments`	Get comments from a discussion	owner, repo, discussionNumber, after, perPage
`list_discussion_categories`	List discussion categories with their id and name, for a repository or organisation	owner, repo (optional)
`list_discussions`	List discussions for a repository or organisation	owner, repo (optional), category, orderBy, direction, after, perPage

Gists Toolset (3 tools)

Create and manage GitHub Gists for code snippets and sharing.

Tool Name	Purpose	Key Parameters
`create_gist`	Create a new gist	filename, content, description (optional), public
`list_gists`	List gists for a user	username (optional), since, page, perPage
`update_gist`	Update an existing gist	gist_id, filename, content, description (optional)

Labels Toolset (3 tools)

Manage repository and issue labels for organization and categorization.

Tool Name	Purpose	Key Parameters
`get_label`	Get a specific label from a repository	owner, repo, name
`label_write`	Perform write operations on repository labels (create, update, or delete)	method, owner, repo, name, color (optional), description (optional), new_name (optional)
`list_label`	List labels from a repository or an issue	owner, repo, issue_number (optional)

Stargazers Toolset (1 tool)

Manage starred repositories for tracking interesting projects.

Tool Name	Purpose	Key Parameters
`list_starred_repositories`	List starred repositories	username (optional), sort, direction, page, perPage

Releases Toolset (3 tools)

Manage and retrieve information about GitHub releases.

Tool Name	Purpose	Key Parameters
`get_latest_release`	Get the latest release in a GitHub repository	owner, repo
`get_release_by_tag`	Get a specific release by its tag name in a GitHub repository	owner, repo, tag
`list_releases`	List releases in a GitHub repository	owner, repo, page, perPage

Code Security Toolset (2 tools)

Code scanning alerts for identifying security vulnerabilities in code.

Tool Name	Purpose	Key Parameters
`get_code_scanning_alert`	Get details of a specific code scanning alert in a GitHub repository	owner, repo, alertNumber
`list_code_scanning_alerts`	List code scanning alerts in a GitHub repository	owner, repo, state, severity, ref, tool_name

Dependabot Toolset (2 tools)

Dependabot alerts for managing dependency vulnerabilities.

Tool Name	Purpose	Key Parameters
`get_dependabot_alert`	Get details of a specific dependabot alert in a GitHub repository	owner, repo, alertNumber
`list_dependabot_alerts`	List dependabot alerts in a GitHub repository	owner, repo, state, severity

Secret Protection Toolset (2 tools)

Secret scanning alerts for detecting exposed credentials and tokens.

Tool Name	Purpose	Key Parameters
`get_secret_scanning_alert`	Get details of a specific secret scanning alert in a GitHub repository	owner, repo, alertNumber
`list_secret_scanning_alerts`	List secret scanning alerts in a GitHub repository	owner, repo, state, resolution, secret_type

Security Advisories Toolset (4 tools)

Access and manage security advisories at global and repository levels.

Tool Name	Purpose	Key Parameters
`get_global_security_advisory`	Get a global security advisory	ghsaId
`list_global_security_advisories`	List global security advisories from GitHub	type, severity, ecosystem, affects, cveId, cwes, ghsaId, isWithdrawn, published, modified, updated
`list_org_repository_security_advisories`	List repository security advisories for a GitHub organization	org, state, sort, direction
`list_repository_security_advisories`	List repository security advisories for a GitHub repository	owner, repo, state, sort, direction

Projects Toolset (9 tools)

GitHub Projects management for project planning and tracking.

Tool Name	Purpose	Key Parameters
`add_project_item`	Add a specific Project item for a user or org	owner_type, owner, project_number, item_type, item_id
`delete_project_item`	Delete a specific Project item for a user or org	owner_type, owner, project_number, item_id
`get_project`	Get Project for a user or org	project_number, owner_type, owner
`get_project_field`	Get Project field for a user or org	owner_type, owner, project_number, field_id
`get_project_item`	Get a specific Project item for a user or org	owner_type, owner, project_number, item_id
`list_project_fields`	List Project fields for a user or org	owner_type, owner, project_number, per_page
`list_project_items`	List Project items for a user or org	owner_type, owner, project_number, query, per_page
`list_projects`	List Projects for a user or org	owner_type, owner, query, per_page
`update_project_item`	Update a specific Project item for a user or org	owner_type, owner, project_number, item_id, updated_field

Users Toolset (2 tools)

User information and search capabilities.

Tool Name	Purpose	Key Parameters
`get_me`	Get details of the authenticated GitHub user	(none)
`search_users`	Find GitHub users by username, real name, or other profile information	query, sort, order, page, perPage

Organizations Toolset (3 tools)

Organization and team management operations.

Tool Name	Purpose	Key Parameters
`get_team_members`	Get member usernames of a specific team in an organization	org, team_slug
`get_teams`	Get details of the teams the user is a member of	user (optional)
`search_orgs`	Find GitHub organizations by name, location, or other organization metadata	query, sort, order, page, perPage

Context Toolset (5 tools)

Enhanced context and support capabilities for intelligent GitHub operations.

Tool Name	Purpose	Key Parameters
`get_copilot_space`	Provide additional context to the chat from a specific Copilot space	owner, name
`github_support_docs_search`	Retrieve documentation relevant to answer GitHub product and support questions	query
`list_copilot_spaces`	Retrieves the list of Copilot Spaces accessible to the user, including their names and owners	(none)
`package_search`	Search for a package across package managers (NPM, PyPI, RubyGems, etc.) and find its GitHub repository	packageName, packageManager (optional)
`web_search`	Perform an AI-powered web search to provide intelligent, contextual answers with citations	query

Usage Examples

Example 1: Automated Pull Request Review Workflow

# Workflow: Review PR with Copilot and check CI status
1. request_copilot_review(owner="myorg", repo="myrepo", pullNumber=42)
2. pull_request_read(method="get_status", owner="myorg", repo="myrepo", pullNumber=42)
3. list_workflow_runs(owner="myorg", repo="myrepo", workflow_id="ci.yml")

Example 2: Security Alert Monitoring

# Workflow: Check all security alerts across different types
1. list_code_scanning_alerts(owner="myorg", repo="myrepo", state="open")
2. list_dependabot_alerts(owner="myorg", repo="myrepo", state="open", severity="high")
3. list_secret_scanning_alerts(owner="myorg", repo="myrepo", state="open")

Example 3: Issue Triage with Sub-Issues

# Workflow: Create parent issue with sub-issues for complex features
1. create_issue(owner="myorg", repo="myrepo", title="New Feature: User Dashboard", body="...")
2. add_sub_issue(owner="myorg", repo="myrepo", issue_number=123, sub_issue_id=124)
3. add_sub_issue(owner="myorg", repo="myrepo", issue_number=123, sub_issue_id=125)
4. reprioritize_sub_issue(owner="myorg", repo="myrepo", issue_number=123, sub_issue_id=125, before_id=124)

Toolset Configuration Reference

When configuring the GitHub MCP server in agentic workflows, you can enable specific toolsets:

tools:
  github:
    mode: "remote"  # or "local"
    toolset: [all]  # or specific toolsets

Available toolset options:

context - GitHub Actions context, Copilot spaces, support docs, package search, web search
repos - Repository operations, file management, branches, commits, search
issues - Issue management, comments, sub-issues
pull_requests - Pull request operations, reviews, merging
actions - GitHub Actions workflows, runs, jobs, logs, artifacts
code_security - Code scanning alerts
dependabot - Dependabot alerts
discussions - GitHub Discussions
gists - Gist operations
labels - Label management
notifications - Notification management
orgs - Organization operations, teams
projects - GitHub Projects management
secret_protection - Secret scanning alerts
security_advisories - Security advisories (global and repository)
stargazers - Repository stars
users - User information and search
all - Enable all toolsets

Notes and Observations

Key Findings

Comprehensive Coverage: The GitHub MCP Remote Server provides 103 tools covering all major GitHub operations, from basic repository management to advanced security scanning and project management.
AI-Enhanced Capabilities: Multiple tools integrate GitHub Copilot functionality:
- create_pull_request_with_copilot - Delegates implementation tasks to Copilot
- assign_copilot_to_issue - Assigns Copilot to resolve issues
- request_copilot_review - Automated code reviews
- get_copilot_space / list_copilot_spaces - Context from Copilot spaces
Security-First Design: Robust security toolset with 10 tools across three categories:
- Code Security (code scanning)
- Dependabot (dependency vulnerabilities)
- Secret Protection (exposed credentials)
- Security Advisories (vulnerability database)
Advanced Search Capabilities: Multiple search modalities:
- search_code - Fast keyword-based code search across all GitHub
- semantic_code_search - Natural language queries within a repository
- search_repositories / search_issues / search_pull_requests / search_users / search_orgs - Comprehensive entity search
- github_support_docs_search - GitHub documentation search
- web_search - AI-powered web search with citations
- package_search - Package manager integration
Workflow Automation: The Actions toolset provides complete CI/CD control:
- Trigger workflows manually
- Monitor runs and jobs
- Access logs (with optimized get_job_logs for failed jobs only)
- Manage artifacts
- Re-run failed jobs or entire workflows
Project Management: Full GitHub Projects v2 support with 9 tools for:
- Project creation and management
- Item tracking and updates
- Field customization
- Query-based filtering
Sub-Issue Tracking: Advanced issue hierarchy with:
- add_sub_issue / remove_sub_issue - Parent-child relationships
- reprioritize_sub_issue - Flexible ordering
- list_sub_issues - Hierarchy visualization
Pending Review Workflow: Multi-step PR review process:
- create_pending_pull_request_review - Start review
- add_comment_to_pending_review - Add inline comments
- submit_pending_pull_request_review - Submit review
- delete_pending_pull_request_review - Cancel if needed
Notification Management: Comprehensive notification control with 6 tools for staying updated on GitHub activity without overwhelming the user.
File Operations: Multiple approaches for file management:
- create_or_update_file - Single file operations
- push_files - Batch file operations in one commit
- delete_file - File removal

Performance Considerations

Expensive Operations: get_workflow_run_logs downloads ALL logs as ZIP - use get_job_logs with failed_only=true for debugging
Pagination: Most list operations support pagination with page and perPage parameters (max 100 per page)
Search Quotas: GitHub API has rate limits - use specific searches to avoid exhausting quotas

Best Practices

Use Copilot Integration: Leverage assign_copilot_to_issue and create_pull_request_with_copilot for automated development
Optimize Log Access: Use get_job_logs(failed_only=true) instead of downloading full workflow logs
Batch File Operations: Use push_files for multiple files in a single commit
Security Monitoring: Regularly check all three security alert types (code scanning, Dependabot, secret scanning)
Notification Hygiene: Use manage_notification_subscription to control notification volume
Project Organization: Use sub-issues for complex features to improve tracking and planning

Methodology

Discovery Method: Self-inspection of available tools in the GitHub MCP remote server via function signature analysis
MCP Configuration: Remote mode with all toolsets enabled
Categorization: Based on GitHub API domains and functionality patterns
Documentation: Derived from tool names, parameter schemas, and usage descriptions
Verification: Cross-referenced with GitHub API documentation and MCP server specifications

Report Generated By: GitHub MCP Remote Server Tools Report Generator
Repository: githubnext/gh-aw
Workflow: Automated MCP Tools Documentation
Cache Location: /tmp/gh-aw/cache-memory/github-mcp-tools.json

AI generated by GitHub MCP Remote Server Tools Report Generator

2025-11-28T16:19:47Z

github-actions[bot]
bot Nov 28, 2025
Author

This discussion was automatically closed because it was created by an agentic workflow more than 1 month ago.

0 replies

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

GitHub MCP Remote Server Tools Report - October 12, 2025 #1581

Uh oh!

{{title}}

Uh oh!

Replies: 1 comment

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

GitHub MCP Remote Server Tools Report - October 12, 2025 #1581

Uh oh!

github-actions[bot] bot Oct 12, 2025

GitHub MCP Remote Server Tools Report

Executive Summary

Overview

Tools by Toolset

Pull Requests Toolset (14 tools)

Issues Toolset (13 tools)

Repositories Toolset (17 tools)

GitHub Actions Toolset (14 tools)

Notifications Toolset (6 tools)

Discussions Toolset (4 tools)

Gists Toolset (3 tools)

Labels Toolset (3 tools)

Stargazers Toolset (1 tool)

Releases Toolset (3 tools)

Code Security Toolset (2 tools)

Dependabot Toolset (2 tools)

Secret Protection Toolset (2 tools)

Security Advisories Toolset (4 tools)

Projects Toolset (9 tools)

Users Toolset (2 tools)

Organizations Toolset (3 tools)

Context Toolset (5 tools)

Usage Examples

Example 1: Automated Pull Request Review Workflow

Example 2: Security Alert Monitoring

Example 3: Issue Triage with Sub-Issues

Toolset Configuration Reference

Notes and Observations

Key Findings

Performance Considerations

Best Practices

Methodology

Replies: 1 comment

Uh oh!

github-actions[bot] bot Nov 28, 2025 Author

github-actions[bot]
bot Oct 12, 2025

github-actions[bot]
bot Nov 28, 2025
Author