Skip to content

v2.7.6 — tool annotations, description fixes, 5 new skills

Choose a tag to compare

@surendranb surendranb released this 14 Jul 03:05

What's new

Tool annotations — all read tools now declare readOnlyHint: true; search_skills declares openWorldHint: true (it makes external GitHub calls). Clients that honour annotations can present tools correctly without confirmation dialogs on read operations.

Description fixes — the four schema-exploration tools (list_dimension_categories, list_metric_categories, get_dimensions_by_category, get_metrics_by_category) now explain their return shape, where they fit in the workflow, and when to use search_schema instead. get_ga4_data gains a return value description.

5 new skills — added to the remote skills library (no future PyPI release needed to extend these):

  • common-metric-names — correct API names for the fields models most often get wrong (keyEvents not conversions, screenPageViews not pageViews, etc.)
  • filter-structures — correct JSON shape for dimension_filter with templates for AND, OR, NOT, IN LIST
  • attribution-scope — when to use session-scoped vs first-user vs event-scoped dimensions
  • traffic-diagnosis — step-by-step methodology to diagnose traffic spikes, drops, or channel shifts
  • ga4-limitations — what the GA4 Data API cannot do (funnels, cohort retention, path analysis) and where to go instead

skill_query telemetrysearch_skills now captures the query the model passes, feeding the loop: usage → identify gaps → add new skills.