v0.2.0

Features

• Logs API — raw, un-sampled row export — four new tools (logs_request, logs_status, logs_download, logs_clean) expose the raw session (visits) and hit (hits) rows the aggregate Reporting API can't return. The async lifecycle (request → poll → download → clean) is shaped as a small, agent-friendly surface rather than mirrored 1:1 from the REST endpoints: logs_request checks feasibility then queues preparation, logs_status polls it and reports storage-quota usage, and logs_download returns a bounded inline sample by default or streams the full export to a file — so raw content (potentially millions of rows) never enters the model's context. Personal fields (IP, clientID, URLs) are flagged via contains_personal_data rather than blocked, and Logs API field ids are discoverable through get_metadata

Improvements

• Installable as a Claude Code plugin — the repo now ships as a Claude Code plugin and can be added straight from the client, with the one-line install documented in the Quickstart
• Automatic client configuration — a root .mcp.json lets MCP clients discover and configure the server (command, args, and directory) without hand-writing the entry

Bug Fixes

• contains_sensitive_data surfaced in report metadata — the Reporting API sets this flag when limited-disclosure rules were applied, but the formatter silently dropped it; it is now included in every report's meta, so an agent can tell when Yandex Metrica suppressed part of a result (thanks @SergeNS-mne, #9)

Docs

• README leads with a demo GIF and secretless login — the README now opens with a demo GIF and a no-app-registration, PKCE-login quickstart, so the fastest path to a working server is the first thing a reader sees

Internal / Dependencies

• Hardened release pipeline — CI actions are pinned to commit SHAs and the release publish job was tightened (#6), and releases now auto-publish to the official MCP registry via OIDC (no secrets)
• Dependabot moved to the bun ecosystem so it updates bun.lock, with minor/patch bumps auto-merged and update PRs grouped
• Bump @types/node to 26.1.1 (#8), the dev-dependencies group (#7, #10), and actions/checkout to v7 (#3)

Full Changelog: v0.1.3...v0.2.0

v0.1.3

Bug Fixes

• E-commerce revenue metrics — the catalog shipped revenue metric ids without the required <currency> token, so every e-commerce revenue query failed with "incorrectly specified metric" (4002). They now use ym:s:ecommerce<currency>ConvertedRevenue (and the per-purchase/per-visit variants), verified against the live API.

Features

• Time-series date axis — run_timeseries now returns time_axis.dates, one calendar-aligned date per value (plus interval_count), so you no longer reconstruct the axis with error-prone date1 + index math. Labels are bucket starts matching how Metrica buckets /bytime (week = Monday; month/quarter/year = period start), correct even for a mid-period start date.
• Actionable tool errors — errors now carry structuredContent (status and error types) plus a recovery hint: re-authenticate on an expired/invalid token, back off when throttled, with distinct timeout and network messages. Request timeouts and network failures map to a typed, retryable error instead of an opaque one.

Improvements

• Pagination awareness — report responses warn when rows remain after the returned page (offset-aware, so the final page stays quiet) and expose meta.total_rows_approximate.
• Clearer comparisons — run_comparison documents its delta convention (delta = B − A, segment A is the baseline) in the tool description and a delta_convention field.
• Metadata guidance — get_metadata now flags the <currency> token for revenue metrics and recommends pulling ym:s:robotPercentage when analyzing raw traffic.

Housekeeping

• Release notes now live in GitHub Releases; dropped CHANGELOG.md and the inert .dxt manifest.json.

Full Changelog: v0.1.2...v0.1.3

v0.1.2

What's Changed

• chore(deps): bump actions/setup-node from 4 to 6 by @dependabot[bot] in #1

New Contributors

• @dependabot[bot] made their first contribution in #1

Full Changelog: https://github.com/BoxLab-Ltd/yandex-metrica-mcp/commits/v0.1.2