Skip to content

Add experimental branch MCP tools - #271

Draft
nathanjcochran wants to merge 3 commits into
mainfrom
nathan/branches-3-branch-tools
Draft

nathanjcochran wants to merge 3 commits into
mainfrom
nathan/branches-3-branch-tools

Conversation

@nathanjcochran

@nathanjcochran nathanjcochran commented Oct 21, 2026 •

Copy link
Copy Markdown
Member

Adds MCP tools mirroring the tiger branch commands, registered only behind TIGER_EXPERIMENTAL: branch_create, branch_list, branch_get, branch_delete, branch_start, branch_stop, branch_resize, branch_rename, and branch_update_password.

  • The tools take IDs only. The resolve endpoint also matches names, so a match by name is refused.
  • branch_create and branch_resize take an iops parameter. The branch tools return IOPS in resources, as the service tools do, and branch_get also returns the parent's service_name.
  • branch_get and branch_create take with_password, as service_get and service_create do. branch_get fails if no password is stored, and branch_create falls back to the password from the create response.
  • The write tools are subject to read-only mode like the service tools, with a branch counting as DEV.

Follow-up: in the MCP test harness, an unexpected mock call inside a tool handler makes the test hang until the go test timeout instead of failing. gomock's Fatalf ends the handler goroutine without a response.

@nathanjcochran
nathanjcochran added this pull request to stack #273 October 21, 2026 22:07
@nathanjcochran nathanjcochran changed the title Add branch MCP tools Add experimental branch MCP tools Oct 21, 2026
@nathanjcochran nathanjcochran self-assigned this Oct 21, 2026
@nathanjcochran
nathanjcochran force-pushed the nathan/branches-3-branch-tools branch 2 times, most recently from d607624 to 9cc969a Compare October 22, 2026 21:41
@nathanjcochran
nathanjcochran force-pushed the nathan/branches-3-branch-tools branch from 9cc969a to fbf8f2b Compare October 23, 2026 21:47
@nathanjcochran
nathanjcochran force-pushed the nathan/branches-3-branch-tools branch 3 times, most recently from cdfab6b to 722fb1c Compare October 26, 2026 21:39
@nathanjcochran
nathanjcochran force-pushed the nathan/branches-3-branch-tools branch from 722fb1c to 256b40c Compare October 26, 2026 21:46
Base automatically changed from nathan/branches-2-existing-commands to main October 26, 2026 21:58
@nathanjcochran
nathanjcochran force-pushed the nathan/branches-3-branch-tools branch from 256b40c to 2b7ff27 Compare October 26, 2026 21:58
Behind the experimental gate, the branch_create, branch_list, branch_get,
branch_delete, branch_start, branch_stop, branch_resize, branch_rename, and
branch_update_password tools mirror the tiger branch commands. Like the
other tools, they take IDs only.
Like service_get and service_create, the branch tools can include the
branch's tsdbadmin password in their result and connection string.
branch_get fails when no password is stored. branch_create falls back to
the password from the create response, which it keeps aside since waiting
replaces the branch with one that carries none.
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.

1 participant