Skip to content

Document list_branches tool in Mintlify MCP#5605

Merged
ethanpalm merged 2 commits intomainfrom
mintlify/document-list-branches-tool-1777534816
Apr 30, 2026
Merged

Document list_branches tool in Mintlify MCP#5605
ethanpalm merged 2 commits intomainfrom
mintlify/document-list-branches-tool-1777534816

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented Apr 30, 2026

Summary

Documents the new list_branches tool added to the Mintlify MCP. The tool lets MCP clients enumerate git branches available for the project (with an optional query filter) and returns the branches, total count, and the deploy branch. It can be called before checkout to attach to an existing branch by name.

Changes

  • Added list_branches to the Session tool list in ai/mintlify-mcp.mdx with a description of inputs and outputs.
  • Updated the session flow's "Check out a branch" step to mention discovering existing branches with list_branches before checkout.

Note

Low Risk
Low risk documentation-only change that adds guidance for a new tool without impacting runtime behavior.

Overview
Documents the new list_branches Mintlify MCP tool, describing its optional filtering and returned metadata (branch names, total count, deploy branch).

Updates the session workflow to recommend calling list_branches before checkout when you want to discover or attach to an existing branch.

Reviewed by Cursor Bugbot for commit 2de3c5d. Bugbot is set up for automated code reviews on this repo. Configure here.

Generated-By: mintlify-agent
@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented Apr 30, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Apr 30, 2026, 7:44 AM

@mintlify-development
Copy link
Copy Markdown
Contributor

mintlify-development Bot commented Apr 30, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
userauth 🟢 Ready View Preview Apr 30, 2026, 7:45 AM

Comment thread ai/mintlify-mcp.mdx Outdated
@ethanpalm ethanpalm merged commit 52353cd into main Apr 30, 2026
4 checks passed
@ethanpalm ethanpalm deleted the mintlify/document-list-branches-tool-1777534816 branch April 30, 2026 17:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants