Skip to content

[mcp-tools] Update GitHub MCP toolsets mapping and documentation to v2.0 - #17700

Closed
github-actions[bot] wants to merge 2 commits into
mainfrom
update-github-mcp-tools-mapping-2026-02-22-748c19bd19c00a85
Closed

[mcp-tools] Update GitHub MCP toolsets mapping and documentation to v2.0#17700
github-actions[bot] wants to merge 2 commits into
mainfrom
update-github-mcp-tools-mapping-2026-02-22-748c19bd19c00a85

Conversation

@github-actions

@github-actionsgithub-actionsBot commented Feb 22, 2026

Copy link
Copy Markdown
Contributor

This PR updates documentation and tool mappings to align with the GitHub MCP server v2.0 toolset structure, as identified in the 2026-02-22 tools audit.

Changes

pkg/workflow/data/github_tool_to_toolset.json

Added 31 new tool mappings discovered in MCP server v2.0:

  • context toolset: get_copilot_space, github_support_docs_search, list_copilot_spaces (new Copilot-focused tools replacing get_teams/get_team_members)
  • repos toolset: get_repository_tree (new tool)
  • issues toolset: list_issue_types (new tool); moved search_issuessearch toolset
  • pull_requests toolset: moved search_pull_requestssearch toolset
  • actions toolset: actions_get, actions_list (renamed from get_workflow_run, list_workflow_runs)
  • dependabot toolset: get_dependabot_alert, list_dependabot_alerts (previously unmapped)
  • discussions toolset: get_discussion, get_discussion_comments, list_discussion_categories
  • gists toolset: get_gist
  • labels toolset: list_label (alongside existing list_labels)
  • notifications toolset: get_notification_details
  • orgs toolset: list_org_repository_security_advisories
  • projects toolset: all 6 project tools (get_project, get_project_field, get_project_item, list_project_fields, list_project_items, list_projects)
  • secret_protection toolset: get_secret_scanning_alert
  • security_advisories toolset: all 3 advisory tools
  • stargazers toolset: list_starred_repositories
  • search toolset: search_code, search_issues, search_orgs, search_pull_requests

skills/github-mcp-server/SKILL.md

Updated to reflect v2.0 tool names:

  • Replaced outdated context tools (get_teams, get_team_members) with new Copilot tools
  • Updated actions toolset to use new tool names (actions_list, actions_get)
  • Added all new toolsets with accurate tool listings
  • Added Legacy Tool Name Mapping table for migration from older allowed: configurations
  • Updated migration guide with current tool names

.github/instructions/github-mcp-server.instructions.md (new file)

Created comprehensive GitHub MCP server instructions file:

  • Complete tool reference organized by toolset (all 56 tools)
  • Configuration examples for common workflow patterns
  • Authentication details for remote and local modes
  • Token permissions reference table
  • Recommended default toolsets with rationale
  • Known limitations (billing data, GITHUB_TOKEN restrictions)

Audit Summary

ToolsetTools in v2.0Notes
context3New Copilot-focused tools
repos10Added get_repository_tree
issues4Added list_issue_types
pull_requests3Reduced to read-only tools
actions3Renamed tools
code_security2Unchanged
dependabot2Previously undocumented
discussions4Expanded read tools
experiments0Empty
gists2Read-focused
labels2Renamed list_labelslist_label
notifications2Added get_notification_details
orgs1Focused on security advisories
projects6Previously undocumented
secret_protection2Unchanged
security_advisories3Previously undocumented
stargazers1Previously undocumented
users0Empty (requires PAT)
search6Expanded
Total56

References:§22277200550

Generated by GitHub MCP Remote Server Tools Report Generator

  • expires on Feb 24, 2026, 12:45 PM UTC


✨ PR Review Safe Output Test - Run 22277347943

💥 [THE END] — Illustrated by Smoke Claude

- Add 31 new tool mappings to github_tool_to_toolset.json for tools
introduced in MCP server v2.0 (copilot context tools, project tools,
security advisory tools, dependabot tools, search toolset expansion,
actions renamed tools, and more)
- Update SKILL.md with current tool names per v2.0 JSON mapping,
including legacy tool name mapping table for migration guidance
- Create .github/instructions/github-mcp-server.instructions.md with
comprehensive tool reference, configuration examples, authentication
details, and recommended toolset rationale
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actionsgithub-actionsBot added automation documentation Improvements or additions to documentation labels Feb 22, 2026
@github-actions

Copy link
Copy Markdown
ContributorAuthor

✅ Pull request created: #17700

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
ContributorAuthor

✅ Commit pushed: 49bc879

@pelikhan
pelikhan deleted the update-github-mcp-tools-mapping-2026-02-22-748c19bd19c00a85 branch August 18, 2026 23:39
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automationdocumentationImprovements or additions to documentationsmoke-claude

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@pelikhan@Karim13014