Skip to content

Conversation

@rdimitrov
Copy link
Member

@rdimitrov rdimitrov commented Feb 6, 2026

Updates the ToolHive extensions schema documentation to document the nested kubernetes metadata structure.

Details:

  • Add explanation that metadata can include an optional kubernetes nested object
  • Document that this metadata only appears for servers auto-discovered from Kubernetes deployments

Description

Type of change

  • Documentation update

Related issues/PRs

Screenshots

Submitter checklist

Content and formatting

  • I have reviewed the content for technical accuracy
  • I have reviewed the content for spelling, grammar, and style

Navigation

  • New pages include a frontmatter section with title and description at a minimum
  • Sidebar navigation (sidebars.ts) updated for added, deleted, reordered, or renamed files
  • Redirects added to vercel.json for moved, renamed, or deleted pages (i.e., if the URL slug changed)

Reviewer checklist

Content

  • I have reviewed the content for technical accuracy
  • I have reviewed the content for spelling, grammar, and style

Related to stacklok/toolhive-registry-server#490

Copilot AI review requested due to automatic review settings February 6, 2026 15:15
@vercel
Copy link

vercel bot commented Feb 6, 2026

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

Project Deployment Actions Updated (UTC)
docs-website Ready Ready Preview, Comment Feb 6, 2026 3:33pm

Request Review

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR enhances the ToolHive extensions schema documentation by documenting the optional kubernetes nested object within the metadata field. This metadata structure is automatically populated by the ToolHive Registry Server when it discovers MCP servers deployed in Kubernetes clusters.

Changes:

  • Added explanation of the optional kubernetes nested object within the metadata field
  • Documented when this metadata appears (auto-discovered Kubernetes deployments)
  • Added an example showing the kubernetes metadata structure in the remote server example

Update the ToolHive extensions schema documentation to document the nested
kubernetes metadata structure.

Add a note explaining that the kubernetes metadata is read-only and
automatically added by the ToolHive Registry Server for auto-discovered
Kubernetes deployments. Users should not manually add this field when
creating custom registry files.

Update the "Full example" section description to clarify it's for building
custom registry files (input), not showing registry server output.
@danbarr danbarr merged commit 49b80fd into main Feb 6, 2026
3 checks passed
@danbarr danbarr deleted the bump-docs branch February 6, 2026 16:34
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