stacklok / stacklok/toolhive

Adopt go-sdk v1.7 for MCP 2026-07-28 stateless support

Open
#5,754 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Go
Stars
2.2k
Forks
300
Avg merge
1d 15h
Merged PRs (30d)
184

Description

Part of #5743 (Workstream C: 2026-07-28 stateless readiness). Gating issue for this workstream.

Work

The 2026-07-28 revision ships as go-sdk v1.7.x (v1.7.0-pre.1 already implements it; stateless is opt-in via StreamableHTTPOptions.Stateless, and endpoints negotiate down to 2025-11-25 for old clients). ToolHive consumes go-sdk through toolhive-core's mcpcompat shim.

  • Track go-sdk v1.7.0 final; evaluate the changelog and the MCPGODEBUG escape hatches (removed in v1.9.0).
  • Determine what the mcpcompat shim needs to expose: the Stateless option, server/discover, MRTR result shapes, subscriptions/listen, per-request _meta protocol fields.
  • Bump toolhive-core → go-sdk v1.7.x, then ToolHive → toolhive-core, behind the regression-test gate from #5742.

Depends on: #5729, stacklok/toolhive-core#156, #5742.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the toolhive-core mcpcompat shim and the go-sdk v1.7.0 changelog, then review the StreamableHTTPOptions.Stateless and MCPGODEBUG details mentioned here. Check the required server/discover, MRTR, subscriptions/listen, and per-request _meta support, then coordinate the toolhive-core and ToolHive version bumps. Done means the regression-test gate from #5742 passes and the listed v1.7 protocol behavior is exposed.

Written by the indexing model from the issue text.

Assessment

Tech stack
go
Domain
api, backend-api-design
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.