Skip to content

Conversation

@triepod-ai
Copy link
Contributor

Summary

Adds ToolAnnotations to all 28 tools across 2 MCP servers to help AI assistants understand tool capabilities.

Changes

chunker_server (7 tools):

  • chunk_text, chunk_markdown, semantic_chunk, sentence_chunk
  • fixed_size_chunk, analyze_text, get_strategies

pm_mcp_server (21 tools):

  • Planning: generate_work_breakdown, build_schedule, critical_path_analysis, produce_gantt_diagram, schedule_optimizer, scope_guardrails, sprint_planning_helper
  • Governance: risk_register_manager, change_request_tracker, baseline_vs_actual, earned_value_calculator
  • Reporting: status_report_generator, project_health_dashboard, project_brief_generator, lessons_learned_catalog, document_template_library
  • Collaboration: meeting_minutes_summarizer, action_item_tracker, resource_allocator, stakeholder_matrix, communications_planner
  • Utility: glossary_lookup, sample_data_catalog

Annotation Details

All tools are computational/analytical with:

  • readOnlyHint=True - No external state modification
  • openWorldHint=False - No external API/network access

Why This Matters

MCP Tool Annotations help AI assistants understand:

  • readOnlyHint: Whether a tool modifies external state (enables safer auto-execution)
  • openWorldHint: Whether a tool accesses external resources

Testing

  • Python syntax check passed for both files

🤖 Generated with Claude Code

Adds ToolAnnotations to all 28 tools across 2 MCP servers:

chunker_server (7 tools):
- chunk_text, chunk_markdown, semantic_chunk, sentence_chunk
- fixed_size_chunk, analyze_text, get_strategies

pm_mcp_server (21 tools):
- Planning: generate_work_breakdown, build_schedule, critical_path_analysis,
  produce_gantt_diagram, schedule_optimizer, scope_guardrails, sprint_planning_helper
- Governance: risk_register_manager, change_request_tracker, baseline_vs_actual,
  earned_value_calculator
- Reporting: status_report_generator, project_health_dashboard, project_brief_generator,
  lessons_learned_catalog, document_template_library
- Collaboration: meeting_minutes_summarizer, action_item_tracker, resource_allocator,
  stakeholder_matrix, communications_planner
- Utility: glossary_lookup, sample_data_catalog

All tools are computational/analytical with:
- readOnlyHint=True (no external state modification)
- openWorldHint=False (no external API/network access)

These annotations help AI assistants understand tool capabilities for safer
and more effective tool selection.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
@crivetimihai crivetimihai self-assigned this Dec 29, 2025
@crivetimihai
Copy link
Member

Good catch, yes, annotations help, thanks for the PR. Reviewing and merging soon :-)

Copy link
Member

@crivetimihai crivetimihai left a comment

Choose a reason for hiding this comment

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

Good PR, thanks!

@crivetimihai crivetimihai merged commit 5b608fd into IBM:main Dec 30, 2025
44 checks 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