Add documentation for ToolHive v0.20.0 by ChrisJBurns · Pull Request #715 · stacklok/docs-website

ChrisJBurns · 2026-04-14T17:14:44Z

Summary

Breaking change: groupRef struct format - Updated all groupRef examples across 12 files from bare string (groupRef: my-group) to the new typed MCPGroupRef struct (groupRef: { name: my-group }). For VirtualMCPServer, moved from deprecated spec.config.groupRef to top-level spec.groupRef.
New feature: telemetryConfigRef for vMCP - Added documentation for spec.telemetryConfigRef to reference shared MCPTelemetryConfig resources, and marked inline spec.config.telemetry as deprecated.
New feature: --stateless flag - Documented the new flag for proxying POST-only remote MCP servers.
New feature: --remote-auth-scope-param-name - Documented the new flag for non-standard OAuth scope parameter names (e.g., Slack's user_scope).
Client compatibility updates - Added Kimi Code CLI and Factory.ai (Droid) as new MCP clients. Updated skills support for 11 existing clients (GitHub Copilot VS Code, Cline, Gemini CLI, Google Antigravity, Goose, Kiro, Mistral Vibe, Roo Code, Sourcegraph Amp CLI, Trae, Windsurf).
Weekly product update - Created blog post for the v0.20.0 release covering all major changes.

Release notes: https://github.com/stacklok/toolhive/releases/tag/v0.20.0

Test plan

Verify all modified YAML examples use the new groupRef struct format
Verify telemetryConfigRef section renders correctly with deprecation warnings
Verify new CLI flag sections (--stateless, --remote-auth-scope-param-name) are clear and accurate
Verify client compatibility table renders correctly with new clients and updated skills columns
Verify blog post renders correctly and links resolve
Confirm no broken links in cross-references

🤖 Generated with Claude Code

vercel · 2026-04-14T17:14:50Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs-website	Ready	Preview, Comment	Apr 15, 2026 6:24pm

Copilot

Pull request overview

Documentation update for the ToolHive v0.20.0 release, covering breaking CRD example changes (notably groupRef), new vMCP telemetry configuration patterns, new CLI flags for remote MCP proxying/auth, updated client compatibility, and a weekly release blog post.

Changes:

Update YAML examples to the new groupRef struct format and (for vMCP) move examples from spec.config.groupRef to spec.groupRef.
Add/expand docs for vMCP telemetryConfigRef vs deprecated inline telemetry, plus new CLI flags --stateless and --remote-auth-scope-param-name.
Refresh the client compatibility matrix and add a v0.20.0 weekly update blog post.

Reviewed changes

Copilot reviewed 16 out of 16 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
docs/toolhive/reference/client-compatibility.mdx	Updates client list and skills support matrix.
docs/toolhive/guides-vmcp/tool-aggregation.mdx	Updates `groupRef` examples for aggregation scenario.
docs/toolhive/guides-vmcp/telemetry-and-metrics.mdx	Adds shared telemetry config reference docs + deprecates inline config.
docs/toolhive/guides-vmcp/quickstart.mdx	Updates quickstart YAML to new `groupRef` format and placement.
docs/toolhive/guides-vmcp/optimizer.mdx	Updates vMCP examples to new `groupRef` format/placement.
docs/toolhive/guides-vmcp/failure-handling.mdx	Updates vMCP YAML examples for `groupRef` changes.
docs/toolhive/guides-vmcp/configuration.mdx	Updates baseline vMCP and backend examples to new `groupRef` usage.
docs/toolhive/guides-vmcp/composite-tools.mdx	Updates composite tools examples to new `groupRef` usage.
docs/toolhive/guides-vmcp/backend-discovery.mdx	Updates backend discovery switch-mode YAML to new `groupRef` usage.
docs/toolhive/guides-vmcp/authentication.mdx	Updates authentication-related examples for `groupRef` changes.
docs/toolhive/guides-vmcp/audit-logging.mdx	Updates audit logging examples for `groupRef` changes.
docs/toolhive/guides-k8s/remote-mcp-proxy.mdx	Updates MCPRemoteProxy example to new `groupRef` struct format.
docs/toolhive/guides-k8s/mcp-server-entry.mdx	Updates MCPServerEntry examples to new `groupRef` struct format.
docs/toolhive/guides-k8s/logging.mdx	Updates VirtualMCPServer logging example to new `groupRef` placement.
docs/toolhive/guides-cli/run-mcp-servers.mdx	Documents `--stateless` and `--remote-auth-scope-param-name` flags.
blog/toolhive-updates/2026-04-14-updates.mdx	Adds weekly v0.20.0 product update post summarizing changes.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Address review feedback: - Fix API group from .com to .dev in MCPTelemetryConfig example - Use correct nested openTelemetry/prometheus spec structure - Move serviceName from MCPTelemetryConfig to telemetryConfigRef - Soften rolling update claim (remove specific TelemetryConfigHash reference) - Add admonition noting telemetryConfigRef is a v0.20.0 feature - Add admonition noting groupRef struct change is a v0.20.0 feature Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Co-authored-by: Dan Barr <danbarr@users.noreply.github.com>

Address PR review feedback: - Remove "two ways" framing and deprecated inline telemetry config section, keeping only the shared MCPTelemetryConfig approach - Update config table and Jaeger example to use new field paths - Remove groupRef v0.20.0 info note from configuration page since CRD ref and migration guide already cover this Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Add documentation for ToolHive v0.20.0 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * Fix MCPTelemetryConfig example and add CRD spec admonitions Address review feedback: - Fix API group from .com to .dev in MCPTelemetryConfig example - Use correct nested openTelemetry/prometheus spec structure - Move serviceName from MCPTelemetryConfig to telemetryConfigRef - Soften rolling update claim (remove specific TelemetryConfigHash reference) - Add admonition noting telemetryConfigRef is a v0.20.0 feature - Add admonition noting groupRef struct change is a v0.20.0 feature Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * Remove weekly product update blog post Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * Update docs/toolhive/guides-vmcp/configuration.mdx Co-authored-by: Dan Barr <danbarr@users.noreply.github.com> * Remove deprecated inline telemetry docs and groupRef info note Address PR review feedback: - Remove "two ways" framing and deprecated inline telemetry config section, keeping only the shared MCPTelemetryConfig approach - Update config table and Jaeger example to use new field paths - Remove groupRef v0.20.0 info note from configuration page since CRD ref and migration guide already cover this Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com> Co-authored-by: Dan Barr <danbarr@users.noreply.github.com>

Copilot AI review requested due to automatic review settings April 14, 2026 17:14

Copilot started reviewing on behalf of ChrisJBurns April 14, 2026 17:15 View session

vercel bot deployed to Preview April 14, 2026 17:15 View deployment

Copilot AI reviewed Apr 14, 2026

View reviewed changes

Comment thread docs/toolhive/guides-vmcp/telemetry-and-metrics.mdx Outdated

Comment thread docs/toolhive/guides-vmcp/telemetry-and-metrics.mdx Outdated

Comment thread docs/toolhive/guides-vmcp/configuration.mdx

Comment thread docs/toolhive/guides-vmcp/telemetry-and-metrics.mdx Outdated

vercel bot deployed to Preview April 14, 2026 17:22 View deployment

vercel bot deployed to Preview April 14, 2026 17:31 View deployment

danbarr reviewed Apr 15, 2026

View reviewed changes

Comment thread docs/toolhive/guides-vmcp/configuration.mdx Outdated

Comment thread docs/toolhive/guides-vmcp/telemetry-and-metrics.mdx Outdated

vercel bot deployed to Preview April 15, 2026 18:13 View deployment

vercel bot deployed to Preview April 15, 2026 18:22 View deployment

ChrisJBurns and others added 5 commits April 15, 2026 19:23

Add documentation for ToolHive v0.20.0

3de8b07

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Remove weekly product update blog post

da5fa1d

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Update docs/toolhive/guides-vmcp/configuration.mdx

bc98c48

Co-authored-by: Dan Barr <danbarr@users.noreply.github.com>

ChrisJBurns force-pushed the add-v0.20.0-docs branch from c448774 to 4efad98 Compare April 15, 2026 18:23

vercel bot deployed to Preview April 15, 2026 18:24 View deployment

danbarr approved these changes Apr 15, 2026

View reviewed changes

ChrisJBurns merged commit 5f38647 into main Apr 15, 2026
4 checks passed

ChrisJBurns deleted the add-v0.20.0-docs branch April 15, 2026 18:37

ChrisJBurns mentioned this pull request Apr 15, 2026

Fix remaining CRD field issues across K8s and vMCP docs #723

Merged

4 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add documentation for ToolHive v0.20.0#715

Add documentation for ToolHive v0.20.0#715
ChrisJBurns merged 5 commits intomainfrom
add-v0.20.0-docs

ChrisJBurns commented Apr 14, 2026

Uh oh!

vercel bot commented Apr 14, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

ChrisJBurns commented Apr 14, 2026

Summary

Test plan

Uh oh!

vercel bot commented Apr 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

vercel bot commented Apr 14, 2026 •

edited

Loading