v2.7.6 — tool annotations, description fixes, 5 new skills
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 (keyEventsnotconversions,screenPageViewsnotpageViews, etc.)filter-structures— correct JSON shape fordimension_filterwith templates for AND, OR, NOT, IN LISTattribution-scope— when to use session-scoped vs first-user vs event-scoped dimensionstraffic-diagnosis— step-by-step methodology to diagnose traffic spikes, drops, or channel shiftsga4-limitations— what the GA4 Data API cannot do (funnels, cohort retention, path analysis) and where to go instead
skill_query telemetry — search_skills now captures the query the model passes, feeding the loop: usage → identify gaps → add new skills.