Skip to content

RFC: Add tool definitions to publisher extensions#15

Merged
rdimitrov merged 2 commits into
mainfrom
rfc/tool-definitions-extension
Jan 26, 2026
Merged

RFC: Add tool definitions to publisher extensions#15
rdimitrov merged 2 commits into
mainfrom
rfc/tool-definitions-extension

Conversation

@JAORMX
Copy link
Copy Markdown
Contributor

@JAORMX JAORMX commented Jan 12, 2026

Summary

Port proposal from toolhive PR #2733.

This RFC proposes adding comprehensive tool metadata to the existing ToolHive publisher extension (io.github.stacklok) in the upstream MCP Registry format. This extends beyond simple tool names to include full MCP tool definitions with descriptions, input/output schemas, and annotations.

What's Changing

  • Adds tool_definitions field to the existing io.github.stacklok publisher extension
  • Stores full MCP tool metadata: name, title, description, inputSchema, outputSchema, annotations
  • Maintains backward compatibility with existing tools string array

Use Cases

  1. Enhanced tooling output - thv list can show tool descriptions
  2. API contract breakage detection - Compare schemas to detect breaking changes in server updates
  3. Client integrations - IDEs/editors can display tool signatures and validate inputs

Technical Details

  • Reuses existing extension namespace (no new namespaces)
  • Aligns with MCP specification tool schema
  • Optional field - servers without it continue to work
  • Type-safe deserialization using existing converter patterns

Port proposal from toolhive PR #2733. This RFC proposes adding
comprehensive tool metadata to the existing ToolHive publisher
extension in the upstream MCP Registry format.

Signed-off-by: Juan Antonio Osorio <ozz@stacklok.com>
Signed-off-by: Juan Antonio Osorio <ozz@stacklok.com>
Comment thread rfcs/THV-0015-tool-definitions-extension.md
Copy link
Copy Markdown
Contributor

@blkt blkt left a comment

Choose a reason for hiding this comment

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

Looks good to me!

@rdimitrov rdimitrov merged commit 426e5de into main Jan 26, 2026
1 check passed
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.

3 participants