GitHub MCP Remote Server Tools Report - 2025-10-11

[github-actions[bot]]

GitHub MCP Remote Server Tools Report

Generated: 2025-10-11
MCP Mode: Remote
Toolsets: All
Repository: githubnext/gh-aw

Executive Summary

• Total Tools Discovered: 128
• Toolset Categories: 16
• Report Date: 2025-10-11

This report documents all available tools/functions in the GitHub MCP remote server when configured with all toolsets enabled. The tools are organized by their respective toolset categories for easy reference.

Tools by Toolset

Context Toolset

Tools for accessing GitHub Actions context and environment information.

Tool Name	Purpose	Key Parameters
get_me	Get details of the authenticated GitHub user	None
github_support_docs_search	Retrieve documentation for GitHub product and support questions	query (user question)
web_search	Perform AI-powered web search for current information	query (search prompt)

Repos Toolset

Tools for repository management and operations.

Tool Name	Purpose	Key Parameters
create_repository	Create a new GitHub repository	name, description, private, organization, autoInit
fork_repository	Fork a repository to your account or organization	owner, repo, organization
search_repositories	Search for repositories by name, description, topics, etc.	query, sort, order, page, perPage, minimal_output
get_file_contents	Get contents of a file or directory from a repository	owner, repo, path, ref, sha
create_or_update_file	Create or update a single file in a repository	owner, repo, path, content, message, branch, sha
delete_file	Delete a file from a repository	owner, repo, path, message, branch
push_files	Push multiple files to a repository in a single commit	owner, repo, branch, files, message
create_branch	Create a new branch	owner, repo, branch, from_branch
list_branches	List branches in a repository	owner, repo, page, perPage
list_commits	Get list of commits for a branch	owner, repo, sha, author, page, perPage
get_commit	Get details for a specific commit	owner, repo, sha, include_diff, page, perPage
list_tags	List git tags in a repository	owner, repo, page, perPage
get_tag	Get details about a specific git tag	owner, repo, tag
search_code	Search for code across GitHub repositories	query, sort, order, page, perPage
semantic_code_search	Search using natural language within a single repository	owner, repo, prompt
manage_repository_notification_subscription	Manage repository notification subscriptions	owner, repo, action (ignore/watch/delete)
package_search	Search for packages across package managers	packageName, packageManager

Issues Toolset

Tools for issue management and tracking.

Tool Name	Purpose	Key Parameters
create_issue	Create a new issue in a repository	owner, repo, title, body, labels, assignees, milestone, type
get_issue	Get details of a specific issue	owner, repo, issue_number
list_issues	List issues in a repository	owner, repo, state, labels, since, orderBy, direction, after, perPage
search_issues	Search for issues using GitHub search syntax	query, owner, repo, sort, order, page, perPage
update_issue	Update an existing issue	owner, repo, issue_number, title, body, state, state_reason, labels, assignees, milestone, type, duplicate_of
add_issue_comment	Add a comment to an issue	owner, repo, issue_number, body
get_issue_comments	Get comments for an issue	owner, repo, issue_number, page, perPage
list_issue_types	List supported issue types for a repository owner	owner
add_sub_issue	Add a sub-issue to a parent issue	owner, repo, issue_number, sub_issue_id, replace_parent
remove_sub_issue	Remove a sub-issue from a parent issue	owner, repo, issue_number, sub_issue_id
list_sub_issues	List sub-issues for a specific issue	owner, repo, issue_number, page, per_page
reprioritize_sub_issue	Change the priority order of a sub-issue	owner, repo, issue_number, sub_issue_id, before_id, after_id

Pull Requests Toolset

Tools for pull request management and code review.

Tool Name	Purpose	Key Parameters
create_pull_request	Create a new pull request	owner, repo, title, body, head, base, draft, maintainer_can_modify
list_pull_requests	List pull requests in a repository	owner, repo, state, head, base, sort, direction, page, perPage
search_pull_requests	Search for pull requests using GitHub search syntax	query, owner, repo, sort, order, page, perPage
pull_request_read	Get information on a specific pull request	owner, repo, pullNumber, method (get/get_diff/get_status/get_files/get_review_comments/get_reviews)
update_pull_request	Update an existing pull request	owner, repo, pullNumber, title, body, state, base, maintainer_can_modify, draft, reviewers
update_pull_request_branch	Update PR branch with latest changes from base	owner, repo, pullNumber, expectedHeadSha
merge_pull_request	Merge a pull request	owner, repo, pullNumber, merge_method, commit_title, commit_message
create_pending_pull_request_review	Create a pending review for a PR	owner, repo, pullNumber, commitID
add_comment_to_pending_review	Add a review comment to pending review	owner, repo, pullNumber, path, body, subjectType, line, startLine, side, startSide
submit_pending_pull_request_review	Submit a pending PR review	owner, repo, pullNumber, event (APPROVE/REQUEST_CHANGES/COMMENT), body
delete_pending_pull_request_review	Delete a pending PR review	owner, repo, pullNumber
create_and_submit_pull_request_review	Create and submit a review without review comments	owner, repo, pullNumber, body, event, commitID
request_copilot_review	Request GitHub Copilot to review a pull request	owner, repo, pullNumber
assign_copilot_to_issue	Assign Copilot coding agent to work on an issue	owner, repo, issueNumber
create_pull_request_with_copilot	Delegate a task to Copilot coding agent	owner, repo, problem_statement, title, base_ref
get_copilot_space	Provide context from a specific Copilot space	owner, name
list_copilot_spaces	List Copilot Spaces accessible to the user	None

Actions Toolset

Tools for GitHub Actions workflow management.

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

Code Security Toolset

Tools for code scanning and security alerts.

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

Dependabot Toolset

Tools for Dependabot alert management.

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

Discussions Toolset

Tools for GitHub Discussions management.

Tool Name	Purpose	Key Parameters
list_discussions	List discussions for a repository or organization	owner, repo, category, orderBy, direction, after, perPage
get_discussion	Get a specific discussion by number	owner, repo, discussionNumber
get_discussion_comments	Get comments from a discussion	owner, repo, discussionNumber, after, perPage
list_discussion_categories	List discussion categories	owner, repo

Gists Toolset

Tools for gist management.

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

Labels Toolset

Tools for label management.

Tool Name	Purpose	Key Parameters
list_label	List labels from a repository or issue	owner, repo, issue_number
get_label	Get a specific label from a repository	owner, repo, name
label_write	Create, update, or delete labels	owner, repo, name, method (create/update/delete), color, description, new_name

Notifications Toolset

Tools for notification management.

Tool Name	Purpose	Key Parameters
list_notifications	List GitHub notifications for the authenticated user	owner, repo, filter, since, before, page, perPage
get_notification_details	Get detailed information for a specific notification	notificationID
dismiss_notification	Mark a notification as read or done	threadID, state (read/done)
mark_all_notifications_read	Mark all notifications as read	owner, repo, lastReadAt
manage_notification_subscription	Ignore, watch, or delete a notification subscription	notificationID, action (ignore/watch/delete)

Orgs Toolset

Tools for organization management.

Tool Name	Purpose	Key Parameters
search_orgs	Search for GitHub organizations	query, sort, order, page, perPage
list_org_repository_security_advisories	List security advisories for an organization	org, state, sort, direction

Projects Toolset

Tools for GitHub Projects management.

Tool Name	Purpose	Key Parameters
list_projects	List projects for a user or organization	owner_type (user/org), owner, query, per_page
get_project	Get a specific project	owner_type, owner, project_number
list_project_items	List items in a project	owner_type, owner, project_number, query, per_page
get_project_item	Get a specific project item	owner_type, owner, project_number, item_id
add_project_item	Add an item to a project	owner_type, owner, project_number, item_type (issue/pull_request), item_id
update_project_item	Update a project item	owner_type, owner, project_number, item_id, updated_field
delete_project_item	Delete an item from a project	owner_type, owner, project_number, item_id
list_project_fields	List fields in a project	owner_type, owner, project_number, per_page
get_project_field	Get a specific project field	owner_type, owner, project_number, field_id

Secret Protection Toolset

Tools for secret scanning alerts.

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

Security Advisories Toolset

Tools for security advisory management.

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

Stargazers Toolset

Tools for repository starring.

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

Users Toolset

Tools for user and team management.

Tool Name	Purpose	Key Parameters
search_users	Search for GitHub users	query, sort, order, page, perPage
get_teams	Get teams the user is a member of	user
get_team_members	Get member usernames of a specific team	org, team_slug

Releases Toolset

Tools for release management.

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

Usage Examples

Example 1: Working with Issues

# List open issues in a repository
- tool: mcp__github__list_issues
  parameters:
    owner: "microsoft"
    repo: "vscode"
    state: "OPEN"
    perPage: 10

# Create a new issue
- tool: mcp__github__create_issue
  parameters:
    owner: "myorg"
    repo: "myrepo"
    title: "Bug: Login form not working"
    body: "Description of the bug..."
    labels: ["bug", "priority-high"]

# Add a comment to an issue
- tool: mcp__github__add_issue_comment
  parameters:
    owner: "myorg"
    repo: "myrepo"
    issue_number: 42
    body: "I can confirm this issue on my machine as well."

Example 2: Managing Pull Requests

# Create a pull request
- tool: mcp__github__create_pull_request
  parameters:
    owner: "myorg"
    repo: "myrepo"
    title: "Add new feature"
    head: "feature-branch"
    base: "main"
    body: "This PR adds the new feature..."

# Request Copilot review
- tool: mcp__github__request_copilot_review
  parameters:
    owner: "myorg"
    repo: "myrepo"
    pullNumber: 123

# Merge the pull request
- tool: mcp__github__merge_pull_request
  parameters:
    owner: "myorg"
    repo: "myrepo"
    pullNumber: 123
    merge_method: "squash"

Example 3: GitHub Actions Workflows

# List workflows
- tool: mcp__github__list_workflows
  parameters:
    owner: "myorg"
    repo: "myrepo"

# Run a workflow
- tool: mcp__github__run_workflow
  parameters:
    owner: "myorg"
    repo: "myrepo"
    workflow_id: "ci.yml"
    ref: "main"

# Get failed job logs
- tool: mcp__github__get_job_logs
  parameters:
    owner: "myorg"
    repo: "myrepo"
    run_id: 12345
    failed_only: true
    return_content: true

Example 4: Code Search

# Search for code across GitHub
- tool: mcp__github__search_code
  parameters:
    query: "function authenticate language:typescript org:myorg"

# Semantic search within a repository
- tool: mcp__github__semantic_code_search
  parameters:
    owner: "myorg"
    repo: "myrepo"
    prompt: "Find all functions that handle user authentication"

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 and environment information
• repos - Repository operations (create, fork, file management, branches, commits, tags, search)
• issues - Issue management (create, list, search, update, comments, sub-issues)
• pull_requests - Pull request operations (create, list, search, review, merge, Copilot integration)
• actions - GitHub Actions workflows (run, monitor, manage jobs, artifacts, logs)
• code_security - Code scanning alerts
• dependabot - Dependabot alerts
• discussions - GitHub Discussions (list, get, comments, categories)
• gists - Gist operations (create, list, update)
• labels - Label management (list, get, create, update, delete)
• notifications - Notification management (list, get details, dismiss, mark read, subscriptions)
• orgs - Organization operations (search, security advisories)
• projects - GitHub Projects (projects, items, fields)
• secret_protection - Secret scanning alerts
• security_advisories - Security advisories (global and repository-level)
• stargazers - Repository stars (list, star, unstar)
• users - User and team information (search, teams)
• all - Enable all toolsets

Notes and Observations

Tool Organization

• The GitHub MCP server provides comprehensive coverage of GitHub's API functionality
• Tools are logically grouped into 16 distinct toolsets, making it easy to enable only what you need
• Most toolsets follow consistent naming patterns (list/get/create/update/delete)

Pagination Support

• Most list operations support pagination via page and perPage parameters
• GraphQL-based operations (issues, discussions) use cursor-based pagination with after parameter
• Maximum perPage is typically 100

Search Capabilities

• Multiple search tools available: repositories, code, issues, pull requests, users, organizations
• search_code uses GitHub's native search syntax for precise code finding
• semantic_code_search provides natural language search within a single repository
• Search tools support sorting, ordering, and advanced query syntax

Copilot Integration

• Three Copilot-related tools: assign_copilot_to_issue, create_pull_request_with_copilot, request_copilot_review
• get_copilot_space and list_copilot_spaces provide context from Copilot Spaces
• Copilot can autonomously work on issues and create pull requests

Security Tools

• Four security-focused toolsets: code_security, dependabot, secret_protection, security_advisories
• Each provides listing and detailed retrieval of alerts
• Support for filtering by state, severity, and other criteria

Actions Workflow Management

• Comprehensive workflow management capabilities
• get_job_logs with failed_only=true is efficient for debugging
• Support for re-running workflows or just failed jobs
• Artifact management included

Project Management

• GitHub Projects v2 support (not the older Projects Classic)
• Supports both user and organization projects
• Full CRUD operations on project items and fields

Notification Management

• Rich notification management capabilities
• Can filter by repository, time range, and participation
• Support for managing subscriptions at both thread and repository level

Review Workflow

• Multi-step review process: create pending → add comments → submit
• Support for line-level and file-level comments
• Can specify side of diff (LEFT for before, RIGHT for after)

Methodology

• Discovery Method: Systematic self-inspection of available GitHub MCP remote server tools
• MCP Configuration: Remote mode with all toolsets enabled
• Categorization: Based on GitHub API domains and logical functionality grouping
• Documentation: Derived from tool names, parameter schemas, and descriptions
• Total Tools: 128 tools across 16 toolsets
• Verification: Each tool validated for accurate name, parameters, and purpose

Additional Resources

• GitHub MCP Documentation: GitHub MCP Server
• GitHub API Reference: GitHub REST API
• MCP Protocol: Model Context Protocol

---

Report Generated: 2025-10-11
Generator: GitHub MCP Remote Server Tools Report Generator
Repository: githubnext/gh-aw

AI generated by GitHub MCP Remote Server Tools Report Generator

[github-actions[bot]]

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