Skip to content

Conversation

@JAORMX
Copy link
Collaborator

@JAORMX JAORMX commented Nov 25, 2025

Summary

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

🤖 Generated with Claude Code

JAORMX and others added 2 commits November 25, 2025 12:15
Proposes adding comprehensive tool metadata to the existing ToolHive
publisher extension in the upstream MCP Registry format. This extends
beyond tool names to include descriptions, input/output schemas, and
annotations from the MCP specification.

Key benefits:
- Richer tool metadata without starting servers
- Better discoverability through descriptions and schemas
- API contract breakage detection via schema comparison
- Foundation for advanced tooling integrations

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
@github-actions github-actions bot added size/S Small PR: 100-299 lines changed and removed size/S Small PR: 100-299 lines changed labels Nov 25, 2025
@codecov
Copy link

codecov bot commented Nov 25, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 55.64%. Comparing base (35a0dc3) to head (96b485d).

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #2733   +/-   ##
=======================================
  Coverage   55.64%   55.64%           
=======================================
  Files         314      314           
  Lines       30445    30445           
=======================================
  Hits        16942    16942           
  Misses      12016    12016           
  Partials     1487     1487           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Copy link
Collaborator

@dmartinol dmartinol left a comment

Choose a reason for hiding this comment

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

if any user has requested it, /lgtm

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/S Small PR: 100-299 lines changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants