io.github.BoxLab-Ltd/yandex-metrica-mcp
NPM · YANDEX-METRICA-MCP · SCANNED AUG 3
Query Yandex Metrica analytics — reports, trends, metadata and raw log exports — via an AI agent.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security87
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to BoxLab-Ltd/yandex-metrica-mcp). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 12 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability60
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 3301 tokens (~275/item across 12 items; 12 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · yandex-metrica-mcp
claude mcp add boxlab-ltd-yandex-metrica-mcp -- npx -y yandex-metrica-mcp
codex mcp add boxlab-ltd-yandex-metrica-mcp -- npx -y yandex-metrica-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"boxlab-ltd-yandex-metrica-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"yandex-metrica-mcp"
],
"enabled": true
}
}
} openclaw mcp add boxlab-ltd-yandex-metrica-mcp --command npx --arg -y --arg yandex-metrica-mcp
mcp_servers:
boxlab-ltd-yandex-metrica-mcp:
command: "npx"
args: ["-y", "yandex-metrica-mcp"] {
"mcpServers": {
"boxlab-ltd-yandex-metrica-mcp": {
"command": "npx",
"args": [
"-y",
"yandex-metrica-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 3 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
- 2 Aug 26 +59
- Install scripts: unverified → pass ▲ security
- Provenance: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- The attested source repository moved: BoxLab-Ltd/yandex-metrica-mcp security
- Security disclosure: fail → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Stability: unverified → 0.23 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Maintenance: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- License: unverified → pass ▲ functional
- Schema quality: unverified → excellent ▲ functional
- Licence: MIT functional
- 31 Jul 26 −7
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 −18
- Tool coverage: 100 → unverified ▼ functional
- 28 Jul 26 +18
- Tool coverage: unverified → 100 ▲ functional
- First check of Schema quality: unverified functional
- First check of Schema quality: fail functional
- First check of Schema quality: fail functional
- First check of Tool coverage: 100 functional
- 27 Jul 26 24
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/[email protected]
Provenance verified
Ecosystem: npm · Outcome: verified
Reason: verified
- Source repo:
- BoxLab-Ltd/yandex-metrica-mcp
- Certificate issuer:
- https://token.actions.githubusercontent.com
- Certificate SAN:
- https://github.com/BoxLab-Ltd/yandex-metrica-mcp/.github/workflows/release.yml@refs/tags/v0.3.0
- Rekor log index:
- 2212214588
- Predicate type:
- https://slsa.dev/provenance/v1
- Subject digest:
- sha512:f54ec5dd4cef91d07e5736567b93ed650356976d9649cb935c3872838ac768cf04df083ebe6f5580b5612f2cfbd51bb576f311ea7efad78c97dbe51eb
- Discovery method:
- attestation_endpoint
Dependencies 95 packages
95 packages in the resolved dependency tree · 95 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
describe_counter Describe Metrica counter ~195
Read a single counter's configuration — settings, goals, segments, filters, operations and access grants — choosing sections with `include`. The goals section returns the goal ids needed to build conversion metrics (ym:s:goal<id>reaches / conversionRate) in run_report, so call this with include=["goals"] before any conversion question. To list the account's counters, use get_metadata. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| counterId | integer | — | Yandex Metrica counter id. Optional if YANDEX_METRIKA_COUNTER_ID is configured. |
| fullResponse | boolean | — | If true, return the full raw objects with every field. Default false: a curated subset to save context. |
| include | array | — | Which configuration sections to return. Default ["settings","goals"]. "goals" gives the goal ids needed for conversion metrics in run_report; "grants" is a read-only access audit. |
No output schema declared.
No examples provided.
get_metadata Get Metrica metadata ~83
Discovery tool. Lists the counters available to your token plus a curated catalog of common dimensions and metrics (Metrica has no enumeration API), attribution options and Logs API fields. Call this before run_report or logs_request to use real field names and to find a counterId. For a counter's own goals, segments, filters or grants, use describe_counter. Read-only.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
login Sign in to Yandex ~108
Sign in to Yandex from here. Opens your browser to approve access; the code returns automatically over a local redirect, so this usually finishes in one call. If the local port is unavailable it returns a URL to approve and you then call submit_code with the code Yandex shows. Run this once (the token lasts ~1 year); needed before the data tools if you are not signed in yet.
| Name | Type | Req | Description |
|---|---|---|---|
| oob | boolean | — | Force the copy-paste flow instead of the automatic local redirect. |
No output schema declared.
No examples provided.
logs_clean Clean or cancel a Metrica log request ~92
Free the counter storage quota by cleaning a finished (processed) log request, or cancel one still being prepared. Dispatches by current status. Destructive: cleaned data must be requested again to download later.
| Name | Type | Req | Description |
|---|---|---|---|
| counterId | integer | — | Yandex Metrica counter id. Optional if YANDEX_METRIKA_COUNTER_ID is configured. |
| requestId | integer | yes | Log request id returned by logs_request. |
No output schema declared.
No examples provided.
logs_download Download Metrica raw logs ~226
Download prepared log data for a request_id (must be status="processed"; check logs_status). Default mode "sample" returns up to maxRows parsed rows inline — cheap and bounded. Mode "file" streams the FULL export to a file and returns its path plus a small preview; the raw content (potentially millions of rows) is never loaded into context. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| counterId | integer | — | Yandex Metrica counter id. Optional if YANDEX_METRIKA_COUNTER_ID is configured. |
| maxRows | integer | — | sample mode only: max rows to return inline (default 100, max 1000). |
| mode | string | — | sample (default): return up to maxRows parsed rows inline — cheap, bounded, no file. file: stream the FULL export to a file and return its path plus a small preview. |
| outputPath | string | — | file mode only: absolute path to write the export to. Defaults to a file in the configured logs directory. |
| requestId | integer | yes | Log request id returned by logs_request. |
No output schema declared.
No examples provided.
logs_request Request Metrica raw logs ~380
Create a Yandex Metrica Logs API request for RAW, un-sampled rows (source="visits" sessions or "hits" events) over a date range. Checks feasibility, then queues preparation (takes minutes). Returns a request_id to poll with logs_status; then logs_download, then logs_clean. Discover field ids with get_metadata. Not read-only: preparing data consumes the counter storage quota.
| Name | Type | Req | Description |
|---|---|---|---|
| attribution | string | — | Attribution model for attribution-dependent fields: FIRST | LAST | LASTSIGN | CROSS_DEVICE_LAST_SIGNIFICANT | AUTOMATIC | ... Default LASTSIGN. |
| counterId | integer | — | Yandex Metrica counter id. Optional if YANDEX_METRIKA_COUNTER_ID is configured. |
| date1 | string | yes | Start date as a concrete YYYY-MM-DD (relative dates are not supported for logs). date2 must be earlier than today — the current day's data is not ready. |
| date2 | string | yes | End date as a concrete YYYY-MM-DD (relative dates are not supported for logs). date2 must be earlier than today — the current day's data is not ready. |
| fields | array | yes | Log field ids to export, e.g. ["ym:s:visitID","ym:s:dateTime","ym:s:startURL"]. All must share the source's prefix (ym:s: for visits, ym:pv: for hits). Discover valid ids with get_metadata (logs_fiel… |
| source | string | yes | Raw data source. "visits" = sessions (ym:s: fields); "hits" = page views/events (ym:pv: fields). Fields must match the source. |
| waitSeconds | integer | — | Optionally poll up to this many seconds for preparation to finish before returning (handy for small exports). Default 0 = return immediately; poll with logs_status afterwards. |
No output schema declared.
No examples provided.
logs_status Check Metrica log requests ~111
Inspect a Logs API request by request_id (status, parts, size, next step), or omit request_id to list all of the counter's log requests and current storage-quota usage. Poll this after logs_request until status="processed". Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| counterId | integer | — | Yandex Metrica counter id. Optional if YANDEX_METRIKA_COUNTER_ID is configured. |
| requestId | integer | — | Log request id to inspect. Omit to list all requests and current quota usage. |
No output schema declared.
No examples provided.
run_comparison Compare Metrica segments ~594
Compare two segments/periods (A vs B) for the same metrics and dimensions (/stat/v1/data/comparison). Returns per-metric values for A and B plus the absolute and percentage delta, computed server-side: delta = B − A (segment A is the baseline), delta_pct = (B − A) / A × 100. Defaults to last 7 days (B) vs the prior 7 days (A), so a positive delta means growth. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| accuracy | string | — | Sampling accuracy: low | medium | high | full, or a 0..1 share. Use "full" for exact data. |
| counterId | integer | — | Yandex Metrica counter id. Optional if YANDEX_METRIKA_COUNTER_ID is configured. |
| date1A | string | — | Segment A start date as YYYY-MM-DD or relative (today, yesterday, NdaysAgo). |
| date1B | string | — | Segment B start date as YYYY-MM-DD or relative (today, yesterday, NdaysAgo). |
| date2A | string | — | Segment A end date as YYYY-MM-DD or relative (today, yesterday, NdaysAgo). |
| date2B | string | — | Segment B end date as YYYY-MM-DD or relative (today, yesterday, NdaysAgo). |
| dimensions | array | — | Dimension ids to group by, e.g. ["ym:s:lastsignTrafficSource"]. Max 10. Do not mix ym:s: and ym:pv: namespaces. |
| filtersA | string | — | Filter expression for segment A. |
| filtersB | string | — | Filter expression for segment B. |
| fullResponse | boolean | — | If true, include all dimension sub-fields (id, icons, …). Default false: only the dimension name and metric values are returned, to save context. |
| includeUndefined | boolean | — | Include rows where the first dimension value is undefined ("Not set"). Default false. |
| limit | integer | — | Rows per page (max 100000). Defaults to a small value to protect context. |
| metrics | array | yes | Metric ids, e.g. ["ym:s:visits","ym:s:users"]. Max 20. Discover valid ids with get_metadata. Do not mix ym:s: (visits) and ym:pv: (hits) namespaces in one call. |
| offset | integer | — | 1-based index of the first row to return, for pagination. Default 1. |
| preset | string | — | Named Metrica report preset (advanced); can substitute for metrics/dimensions. |
| sort | array | — | Sort fields; prefix a field with "-" for descending, e.g. ["-ym:s:visits"]. |
| timezone | string | — | Timezone offset for the report as ±hh:mm, e.g. "+03:00". Defaults to the counter timezone. |
No output schema declared.
No examples provided.
run_drilldown Drill down a Metrica report ~522
Return one level of a hierarchical (tree) report (/stat/v1/data/drilldown). Each row has an "expandable" flag; pass parentId with the path of dimension keys to expand deeper. Requires dimensions. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| accuracy | string | — | Sampling accuracy: low | medium | high | full, or a 0..1 share. Use "full" for exact data. |
| counterId | integer | — | Yandex Metrica counter id. Optional if YANDEX_METRIKA_COUNTER_ID is configured. |
| date1 | string | — | Start date as YYYY-MM-DD or relative (today, yesterday, NdaysAgo). |
| date2 | string | — | End date as YYYY-MM-DD or relative (today, yesterday, NdaysAgo). |
| dimensions | array | — | Dimension ids to group by, e.g. ["ym:s:lastsignTrafficSource"]. Max 10. Do not mix ym:s: and ym:pv: namespaces. |
| filters | string | — | Metrica filter expression in native syntax, e.g. ym:s:regionCityName=='Moscow' AND ym:pv:URL=@'help'. |
| fullResponse | boolean | — | If true, include all dimension sub-fields (id, icons, …). Default false: only the dimension name and metric values are returned, to save context. |
| includeUndefined | boolean | — | Include rows where the first dimension value is undefined ("Not set"). Default false. |
| limit | integer | — | Rows per page (max 100000). Defaults to a small value to protect context. |
| metrics | array | yes | Metric ids, e.g. ["ym:s:visits","ym:s:users"]. Max 20. Discover valid ids with get_metadata. Do not mix ym:s: (visits) and ym:pv: (hits) namespaces in one call. |
| offset | integer | — | 1-based index of the first row to return, for pagination. Default 1. |
| parentId | array | — | Path from the tree root as a list of dimension keys. Omit for the top level. |
| preset | string | — | Named Metrica report preset (advanced); can substitute for metrics/dimensions. |
| sort | array | — | Sort fields; prefix a field with "-" for descending, e.g. ["-ym:s:visits"]. |
| timezone | string | — | Timezone offset for the report as ±hh:mm, e.g. "+03:00". Defaults to the counter timezone. |
No output schema declared.
No examples provided.
run_report Run Metrica report ~498
Query a Yandex Metrica table report (/stat/v1/data): one or more metrics grouped by dimensions over a date range, with optional filter and sort. Read-only. Use get_metadata first to discover valid metric/dimension ids and the account counters.
| Name | Type | Req | Description |
|---|---|---|---|
| accuracy | string | — | Sampling accuracy: low | medium | high | full, or a 0..1 share. Use "full" for exact data. |
| counterId | integer | — | Yandex Metrica counter id. Optional if YANDEX_METRIKA_COUNTER_ID is configured. |
| date1 | string | — | Start date as YYYY-MM-DD or relative (today, yesterday, NdaysAgo). |
| date2 | string | — | End date as YYYY-MM-DD or relative (today, yesterday, NdaysAgo). |
| dimensions | array | — | Dimension ids to group by, e.g. ["ym:s:lastsignTrafficSource"]. Max 10. Do not mix ym:s: and ym:pv: namespaces. |
| filters | string | — | Metrica filter expression in native syntax, e.g. ym:s:regionCityName=='Moscow' AND ym:pv:URL=@'help'. |
| fullResponse | boolean | — | If true, include all dimension sub-fields (id, icons, …). Default false: only the dimension name and metric values are returned, to save context. |
| includeUndefined | boolean | — | Include rows where the first dimension value is undefined ("Not set"). Default false. |
| limit | integer | — | Rows per page (max 100000). Defaults to a small value to protect context. |
| metrics | array | yes | Metric ids, e.g. ["ym:s:visits","ym:s:users"]. Max 20. Discover valid ids with get_metadata. Do not mix ym:s: (visits) and ym:pv: (hits) namespaces in one call. |
| offset | integer | — | 1-based index of the first row to return, for pagination. Default 1. |
| preset | string | — | Named Metrica report preset (advanced); can substitute for metrics/dimensions. |
| sort | array | — | Sort fields; prefix a field with "-" for descending, e.g. ["-ym:s:visits"]. |
| timezone | string | — | Timezone offset for the report as ±hh:mm, e.g. "+03:00". Defaults to the counter timezone. |
No output schema declared.
No examples provided.
run_timeseries Metrica metrics over time ~442
Return metrics split into a time series (/stat/v1/data/bytime): each metric comes back as an array of values, one per interval (day/week/month/…) over the date range. Use for trends and charts. Optionally group by dimensions (topKeys rows). Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| accuracy | string | — | Sampling accuracy: low | medium | high | full, or a 0..1 share. Use "full" for exact data. |
| counterId | integer | — | Yandex Metrica counter id. Optional if YANDEX_METRIKA_COUNTER_ID is configured. |
| date1 | string | — | Start date as YYYY-MM-DD or relative (today, yesterday, NdaysAgo). |
| date2 | string | — | End date as YYYY-MM-DD or relative (today, yesterday, NdaysAgo). |
| dimensions | array | — | Dimension ids to group by, e.g. ["ym:s:lastsignTrafficSource"]. Max 10. Do not mix ym:s: and ym:pv: namespaces. |
| filters | string | — | Metrica filter expression in native syntax, e.g. ym:s:regionCityName=='Moscow' AND ym:pv:URL=@'help'. |
| fullResponse | boolean | — | If true, include all dimension sub-fields (id, icons, …). Default false: only the dimension name and metric values are returned, to save context. |
| group | string | — | Time interval granularity. Default day. |
| includeUndefined | boolean | — | Include rows where the first dimension value is undefined ("Not set"). Default false. |
| metrics | array | yes | Metric ids, e.g. ["ym:s:visits","ym:s:users"]. Max 20. Discover valid ids with get_metadata. Do not mix ym:s: (visits) and ym:pv: (hits) namespaces in one call. |
| timezone | string | — | Timezone offset for the report as ±hh:mm, e.g. "+03:00". Defaults to the counter timezone. |
| topKeys | integer | — | Max number of dimension rows to chart (max 30). Default 7. |
No output schema declared.
No examples provided.
submit_code Submit the Yandex sign-in code ~50
Complete a copy-paste sign-in started by login: pass the code Yandex showed you after you approved access.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | yes | The code shown on the Yandex page after you approved access. |
No output schema declared.
No examples provided.