Releases: github/github-mcp-server
GitHub MCP Server 0.28.1
Highlights
You can now stack PRs with base_ref option for both create_pull_request_with_copilot and assign_copilot_to_issue tools.
What's Changed
- Add base_ref parameter and GraphQL-Features header support to assign_copilot_to_issue tool by @Copilot in #1779
Full Changelog: v0.28.0...v0.28.1
GitHub MCP Server 0.28.0
Highlights
We have introduced the consolidated Projects toolset in this release, this can be enabled through the use of the remote_mcp_consolidated_projects feature flag. Additionally, when using a classic PAT, tools are now filtered based on token scopes. Includes bug fixes.
What's Changed
- Add OAuth scope metadata to all MCP tools by @Copilot in #1679
- Add PAT scope filtering for stdio server by @SamMorrowDrums in #1741
- Replace go-github-mock with stretchr/testify for actions/issues/projects tests by @Copilot in #1737
- Projects consolidation by @mattdholloway in #1706
- Update command instructions for terminal usage by @floriangrousset in #1307
- Fix nil pointer dereference in completion handler by @SamMorrowDrums in #1754
- Update toolset names in remote-server.md docs by @tommaso-moro in #1756
- feat: Add list-scopes command using inventory architecture by @Copilot in #1750
- Update Claude Code installation command for v2.1.1+ add-json format by @Copilot in #1766
- bug fix: --tools flag not working with feature-flagged tools and deprecation aliases by @tommaso-moro in #1775
- Bringing back local mcp server registry config by @almaleksia in #1767
- Fix docs automation to use toolset IDs instead of display names by @Copilot in #1780
- Fix resource handler to use deps from context by @SamMorrowDrums in #1777
- fix: keep all resources registered for resources/read requests by @SamMorrowDrums in #1792
New Contributors
- @floriangrousset made their first contribution in #1307
Full Changelog: v0.27.0...v0.28.0
GitHub MCP Server 0.27.0
Highlights
We improved get_file_contents and push_files tools. We covered many common scenarios that should no longer result in failures. For example, pushing files to non-initialized repos and new branches is possible now.
What's Changed
- Add raw client error annotation and annotate GetFileContents by @omgitsads in #1570
- feat: Add DestructiveHint to delete_project_item tool annotation by @triepod-ai in #1665
get_file_contentsfetch refs improvements by @almaleksia in #1655- remove experiments toolset by @tommaso-moro in #1667
- build(deps): bump docker/setup-buildx-action from 3.11.1 to 3.12.0 by @dependabot[bot] in #1672
- feat: auto-fix license files on PRs and improve CI reliability by @SamMorrowDrums in #1583
- Fix invalid YAML syntax in license-check workflow by @Copilot in #1674
- build(deps): bump github.com/google/jsonschema-go from 0.3.0 to 0.4.2 by @dependabot[bot] in #1670
- build(deps): bump github.com/modelcontextprotocol/go-sdk from 1.2.0-pre.1 to 1.2.0 by @dependabot[bot] in #1671
- Update PR template to include tool renaming section by @tommaso-moro in #1657
- build(deps): bump github.com/spf13/cobra from 1.10.1 to 1.10.2 by @dependabot[bot] in #1558
- Fallback to default branch in get_file_contents when main doesn't exist by @almaleksia in #1669
- fix: Skip CodeQL scanning on forked repositories by @kaovilai in #873
- build(deps): bump docker/metadata-action from 5.9.0 to 5.10.0 by @dependabot[bot] in #1516
- Update docs to remove Claude Web mention by @tommaso-moro in #1684
- Change list workflow runs to allow empty resource id to list all runs in repo by @mattdholloway in #1682
- build(deps): bump actions/github-script from 7 to 8 by @dependabot[bot] in #1699
- Update README.md to hyperlink Open AI Codex installation guide by @s-sanjay in #1692
- docs: add Docker image name to Prerequisites section by @majiayu000 in #1701
- fix: use gh pr checkout to handle fork PRs in license-check workflow by @Copilot in #1709
- refactor: use consistent snake_case for issue_number parameter by @majiayu000 in #1702
- Add API Error annotations to GitHub issue errors by @omgitsads in #1566
- docs: add docs for Rovo Dev CLI installation by @atinylittleshell in #875
- fix: get_job_logs fails by @majiayu000 in #1719
- Exclude tools requiring feature flag from docs by @mattdholloway in #1721
- Improvements to push_files tool by @almaleksia in #1676
New Contributors
- @triepod-ai made their first contribution in #1665
- @kaovilai made their first contribution in #873
- @s-sanjay made their first contribution in #1692
- @majiayu000 made their first contribution in #1701
- @atinylittleshell made their first contribution in #875
Full Changelog: v0.26.3...v0.27.0
GitHub MCP Server 0.26.3
What's Changed
- Add aliases for new actions tools by @tommaso-moro in #1652
Full Changelog: v0.26.2...v0.26.3
GitHub MCP Server 0.26.2
What's Changed
- Fix stdio mode panic: inject ToolDependencies into request context by @Copilot in #1647
Full Changelog: v0.26.1...v0.26.2
GitHub MCP Server 0.26.1
Fixes regression breaking some clients #1644
What's Changed
- Fix ring buffer panic by @mattdholloway in #1556
- Omit icon sizes field for backward compatibility with older MCP clients by @Copilot in #1645
Full Changelog: v0.26.0...v0.26.1
GitHub MCP Server 0.26.0
GitHub MCP Server gets a touch of gloss π
For clients that support icons (part of the newest MCP specification) we now provide them:
Main Features
π¨ Octicon Icons for Tools, Resources, and Prompts
MCP clients that support the new icons specification will now display GitHub's Octicon icons alongside tools and resources, making it easier to identify capabilities at a glance.
ποΈ Inventory Pattern Architecture
A new internal architecture introduces the Inventory pattern with builder, filtering, and per-request optimization. This lays groundwork for better performance and configurability, especially for remote server deployments.
π© Feature Flag Support & Consolidated Actions Toolsets
Added infrastructure for feature flag-based tool enablement, plus a consolidated actions toolset for better organization of GitHub Actions-related tools gated by a feature flag.
--featurescli flag orGITHUB_MCP_FEATURESvia ENV.
π§ Bug Fixes
- Fixed
create_or_updateSHA failures - Resolved issues where file updates could fail due to SHA mismatches - Path parameter now optional - Fixed incorrect required parameter validation
π Documentation
- New Antigravity installation guide
- New tool renaming guide for handling deprecated tool names
What's Changed
- Fix create_or_update SHA-related failures by @almaleksia in #1621
- docs: Add Antigravity installation guide by @ManoloZocco in #1549
- Update docs to include tool renaming guide by @tommaso-moro in #1623
- Update pr template by @JoannaaKL in #1605
- Chore: Add testify-based HTTP mocking infrastructure and pilot migration by @Copilot in #1606
- build(deps): bump actions/cache from 4 to 5 by @dependabot[bot] in #1609
- refactor: Introduce Inventory pattern with builder, filtering, and per-request optimization by @SamMorrowDrums in #1589
- Fix: path param should be optional by @almaleksia in #1631
- fix: track HTTP status code errors in context for observability by @SamMorrowDrums in #1630
- feat: Add Octicon icons to MCP tools, resources, and prompts by @SamMorrowDrums in #1603
- Update docs generation to populate correct docs, remove redundant docs by @tommaso-moro in #1634
- refactor: inject deps via context instead of closures by @SamMorrowDrums in #1640
- Partial migration from go-github-mock to testify-based mocks by @Copilot in #1629
- Add ff support and consolidated actions toolsets by @mattdholloway in #1622
New Contributors
- @ManoloZocco made their first contribution in #1549
Full Changelog: v0.25.0...v0.26.0
GitHub MCP Server 0.26.0-rc.3
Rename registry.Registry to inventory.Inventory in order to avoid a namespace collision with MCP Registry
Full Changelog: v0.26.0-rc.2...v0.26.0-rc.3
GitHub MCP Server 0.26.0-rc.2
v0.26.0-rc.2 Release Notes
Fixes
-
fix(get_file_contents): Restore correct implementation from #1582
- Fixed control flow to resolve git reference SHA before calling GetContents API
- Restored
matchFileshelper function for proper fallback when files aren't found directly - Ensures proper URI construction with resolved SHA (e.g.,
repo://owner/repo/<sha>/contents/path)
-
chore: Update server.json schema to 2025-12-11
- Fixed MCP registry publish workflow by updating to non-deprecated schema
- Removed
statusfield (now managed by registry)
Summary
This pre-release fixes a regression in get_file_contents that was introduced during the registry refactor. The tool was returning empty responses because:
- The resolved SHA wasn't being applied before the GitHub Contents API call
- The
matchFilesfallback logic was incorrectly restructured
Both issues are now fixed, restoring the behavior from PR #1582.
Full Changelog: v0.26.0-rc.1...v0.26.0-rc.2
GitHub MCP Server 0.26.0-rc.1
Highlights
ποΈ Registry Pattern Refactoring
- Migrate context_tools to new ServerTool pattern (#1590)
- Migrate notifications.go to NewTool pattern (#1592)
These PRs are part of a larger refactoring effort moving all tools to a new ServerTool pattern with typed dependency injection. This improves code maintainability and enables better testability.
π Bug Fix
create_or_update_file- SHA is now optional; if not supplied, the tool automatically retrieves the original SHA (#1621)
π Documentation
What's Changed
- Fix create_or_update SHA-related failures by @almaleksia in #1621
- docs: Add Antigravity installation guide by @ManoloZocco in #1549
- Update docs to include tool renaming guide by @tommaso-moro in #1623
- Migrate context_tools to new ServerTool pattern by @SamMorrowDrums in #1590
- refactor(notifications): migrate notifications.go to NewTool pattern by @SamMorrowDrums in #1592
New Contributors
- @ManoloZocco made their first contribution in #1549
Full Changelog: v0.25.0...v0.26.0-rc.1