Wordstat top requests + associations; num_phrases 1..2000; devices DEVICE_* list.

Get Wordstat demand over time using UTC dates YYYY-MM-DD and the server budget gate.

Get Wordstat demand by region for the last 30 days through the server budget gate.

Get the Wordstat region tree through Cloud credentials and the server budget gate.

Prepare an asynchronous Yandex SERP request without a live provider call.

Queue an approved asynchronous Yandex SERP request.

Return durable status for an asynchronous Yandex SERP job.

Return raw provenance metadata and normalized Yandex SERP output.

List Direct campaigns through the strict read allowlist.

Get one Direct campaign by numeric id.

Run a provider-native get against the explicit Direct inventory allowlist.

Read campaign statistics; returns completed TSV rows or safe offline queue status.

Direct Reports statistics broken down by 1-10 Metrika goals and attribution models (FCCD, LC, LSCCD, AUTO). Use for CPA/ROI by goal; for plain cost/clicks use direct_get_statistics. Goal columns: . Read-only.

List Direct shared (portfolio) strategies via Strategies.get v501 with paging. For a campaign's own strategy use direct_get_campaign; type-specific fields via direct_get_inventory service=strategies. Read-only.

Forecast search-volume presence by device for phrases and regions.

Draft a Direct change set and open an unaccepted, expiring approval.

The draft carries a diff hash and an approval_id. A human must accept the approval before direct_apply_changes can execute it.

Apply an accepted Direct change set (from direct_prepare_changes, approved by the operator) exactly once with approval_id + idempotency_key; re-reads campaigns to verify. Writes; spends units. Fails closed without approval.

Idempotent non-destructive Direct write (no deletes or bid changes: use direct_prepare_write) behind the server write flag and audit log. Prefer direct_prepare_changes -> direct_apply_changes for campaign changes. Writes; spends units; confirm with the user first.

List Metrika counters through a server-side read-only credential.

List goals for one positive Metrika counter id.

Run a bounded read-only Metrika reporting request.

Autonomously create or update a Metrika goal (idempotent, readback).

Deleting a goal needs a human approval: metrika_manage_prepare(operation='goal_delete').

One-call Metrika report with optional period comparison (compare_date1/2): totals, abs/% deltas, sampling info, JSON or CSV. Use for period-over-period analysis; raw params via metrika_get_statistics. <=12 metrics, 5 dimensions, 93 days. Read-only.

Read the OAuth account user identifier; OAuth stays on the server.

Read one bounded page of sites accessible to the server account.

Read metadata for an exact Webmaster host identifier.

Read ownership verification state without starting verification.

Read indexing and site summary; missing metrics remain missing.

Read problems with native severity, presence state and state-change time.

Read at most 31 days of aggregate or selected-query indicators.

Read one page of popular queries; explicit periods are at most 31 days.

Read at most 31 days of indexing history.

Read one page of indexing samples with continuation metadata.

Read one page of URLs in search; a sample is not the full index.

Read at most 31 days of search URL count history.

Read at most 31 days of APPEARED_IN_SEARCH / REMOVED_FROM_SEARCH page counts.

Read one page (limit 1-100) of pages that appeared in or were removed from search.

Read site quality index (SQI/ИКС) history; default and maximum period is 366 days.

Read one page of monitored important URLs with indexing and search status.

Read change history of one monitored URL; the URL must belong to the exact host.

Read one sitemap page using the upstream sitemap identifier cursor.

Read detected sitemap details or registration of a submitted sitemap.

Read one page of submitted sitemaps with an exclusive identifier cursor.

Read one page of external link samples.

Read at most 31 days of external link history.

Read one page of broken internal link samples.

Read at most 31 days of broken internal link history.

Read one page of asynchronous recrawl requests.

Read the daily quota and remaining submissions.

Read IN_PROGRESS/DONE/FAILED; DONE does not prove search indexing.

Prepare exactly one URL for human approval after ownership, quota and duplicate checks.

Prepare one sitemap registration for expiring human approval.

Submit one accepted URL exactly once. Uncertain POSTs are reconciled without retransmission.

Submit one accepted sitemap with a durable key and registration readback.

Read and reconcile this principal's existing action. This tool cannot send a POST.

List Audience segments visible to the server-side Audience credential.

Read one segment by filtering the documented authoritative segment list.

List Audience tracking pixels visible to the server-side credential.

Read one pixel by filtering the documented authoritative pixel list.

Validate a closed Audience create payload offline and return its immutable confirmation hash.

Run one guarded geo-circle create; uncertain outcomes are not resent.

Run one guarded geo-polygon create; last is refused and unknowns are not resent.

Run one guarded tracking-pixel create; uncertain outcomes are not resent.

Run one guarded pixel-viewer segment create; uncertain outcomes are not resent.

Reconcile one owned pending create by saved object id without sending another POST.

Check whether a Metrika Logs API export fits the counter quota (possible, max days). Use before metrika_logs_create. source=visits (ym:s:) or hits (ym:pv:); date2 before today. Read-only.

List Logs API requests of a counter with status (created, processed, canceled...) and parts. Use to find request_id. Read-only.

Status and parts of one Logs API request; poll until status=processed, then metrika_logs_download_part. Read-only.

Preview one processed Logs API part as columns + up to max_rows (<=1000) rows; truncated=true if more. For full exports download outside chat. Read-only.

Create a Metrika Logs API export (spends the 10 GB per-counter quota). Run metrika_logs_evaluate and confirm with the user first; needs YANDEX_METRIKA_LOGS_ENABLED. Idempotent by key; then poll metrika_logs_get.

Free Logs API quota: action=clean deletes prepared files of a processed request, cancel stops an unprocessed one. Irreversible; confirm first; needs YANDEX_METRIKA_LOGS_ENABLED.

List an agency's Direct clients (Login, ClientId, ClientInfo, Currency...) via AgencyClients.get; agency tokens only. Use the Login as YANDEX_DIRECT_CLIENT_LOGIN for that client. 10 units + 1/client. Read-only.

Validate offline conversion rows locally (Target, DateTime past Unix secs, one of UserId/ClientId/Yclid/PurchaseId, Price, Currency); returns CSV preview + confirmation_hash. No API call.

Upload offline conversions to Metrika (affects goal stats and Direct optimisation). Needs the hash from metrika_validate_offline_conversions, user confirmation and YANDEX_METRIKA_WRITE_ENABLED.

List offline conversion uploads of a counter (id, status, line counts, type). Read-only.

Status of one offline conversion upload (processing can take up to 3 hours). Read-only.

Own Direct account info (Login, ClientId, currency, type) via Clients.get; no phones/representatives. Agencies: direct_list_agency_clients. Read-only.

Merge duplicate phrases and add cross-negatives via KeywordsResearch.deduplicate before adding keywords. Up to 10000 phrases; nothing is saved. Read-only.

Direct reference dictionaries (Currencies, GeoRegions, TimeZones, Constants, Interests, AdCategories...). Use for region ids/min bids before forecasts or writes. GeoRegions is large. Read-only.

What changed in Direct since timestamp (UTC ISO, Z) via Changes: checkCampaigns (which campaigns), check (objects in given ids), checkDictionaries. Use for incremental sync instead of re-reading everything. Read-only.

Bid adjustments (mobile, demographics, retargeting, regional...) by campaign/group/id; levels CAMPAIGN, AD_GROUP. Read-only.

Bids.get: current Bid/ContextBid plus optional search auction fields for keywords. One of campaign_ids, ad_group_ids, keyword_ids required. Monetary values are micros (×1e6). Read-only.

AdImages.get: uploaded ad images (hash, name, type, subtype, associated). Optional hashes (≤10000) or associated YES/NO. Read-only.

Callout extensions (Id, Type, Status, text). Sitelinks: direct_list_sitelinks. Read-only.

Audience targets (retargeting/interest) by Ids, AdGroupIds or CampaignIds. Read-only.

Retargeting and audience-selection lists (Id, Type, Name, IsAvailable). Read-only.

Creatives (image/HTML5/video/smart): Id, Type, Name, size. Read-only.

Product feeds: status, item count, update time. Read-only.

Turbo pages (Id, Name, Href); use Id for direct_list_leads. Read-only.

Shared negative keyword sets by Ids (required by the API). Read-only.

Ad video status by video Ids (required by the API). Read-only.

Current keyword bids and serving status by CampaignIds, AdGroupIds or KeywordIds (one required). Change bids via direct_write service=bids. Auction data: direct_get_bids. Read-only.

Turbo page leads metadata by TurboPageIds; form data (PII) only with include_data=true. Read-only.

Sitelink sets (Id + Title/Href/Description). Optional Ids filter. Read-only.

Yandex Business profiles (Id, Name, IsPublished, Rubric); no Phone/Address by default. Read-only.

Smart-banner feed filters (SmartAdTargets) by campaign/group/id. Read-only.

Dynamic text ad targeting conditions by campaign/group/id. Read-only.

Dynamic feed ad filters (DynamicFeedAdTargets) by campaign/group/id. Read-only.

Verified owners of a Webmaster host (login, verification type/date). Read-only.

Product/service feeds added to a Webmaster host. Details via webmaster_get_feed. Read-only.

One Webmaster feed's status and errors by feed URL. Read-only.

Host-level feed problems in Webmaster (blocking offers). Read-only.

Webmaster region directory (ids for webmaster_query_analytics region_ids), filter by name. Read-only.

Webmaster query/URL analytics with region and text/statistic filters (up to 500 rows). Deeper than webmaster_list_popular_queries. Read-only.

Enhanced SERP-query export quotas for a host (GET …/pro/limits). Check before webmaster_start_pro_export. Read-only.

Dates available for enhanced SERP-query export (GET …/pro/serp/dates, up to ~550 days). Read-only.

Status of an enhanced export task (IN_PROGRESS / SUCCESS with url / FAILED). Read-only.

Start enhanced SERP-query export (POST …/pro/serp/queries/download/). Spends daily quota; needs YANDEX_WEBMASTER_WRITE_ENABLED. use_pro_tariff=true (paid) first returns an approval to accept, then pass approval_id. Poll webmaster_get_pro_export_status.

Documented Metrika management/report reads by operation name; args = path ids, query{...}. operation='catalog' lists all operations with docs (local). Read-only.

Open an approval for one allowlisted Metrika write/upload (args: ids, query, body, csv). Bound to principal, account and exact request; nothing is sent.

Execute an accepted Metrika write once (write flag, approval_id, idempotency_key), then read back. Same key replays the stored result. Writes.

Settle an uncertain Metrika management write by reading the provider; never resends.

Documented Webmaster management/report reads by operation name; args = path ids, query{...}. operation='catalog' lists all operations with docs (local). Read-only.

Open an approval for one allowlisted Webmaster write/upload (args: ids, query, body, csv). Bound to principal, account and exact request; nothing is sent.

Execute an accepted Webmaster write once (write flag, approval_id, idempotency_key), then read back. Same key replays the stored result. Writes.

Settle an uncertain Webmaster management write by reading the provider; never resends.

Documented Audience management/report reads by operation name; args = path ids, query{...}. operation='catalog' lists all operations with docs (local). Read-only.

Open an approval for one allowlisted Audience write/upload (args: ids, query, body, csv). Bound to principal, account and exact request; nothing is sent.

Execute an accepted Audience write once (write flag, approval_id, idempotency_key), then read back. Same key replays the stored result. Writes.

Settle an uncertain Audience management write by reading the provider; never resends.

Open an approval for one allowlisted Direct write (any service/method; yandex://guide/prepare-apply).

Bound to service, method, items, account and endpoint. Nothing is sent.

Execute an accepted Direct write once (write flag, approval_id, idempotency_key), then read back.

Same key replays the stored result. Writes; spends units.

Check GitHub for a newer zai-yandex-mcp release and suggest the update command. Suggest-only, 24h cache unless force=true; never calls Yandex.

Show which Yandex OAuth services have tokens (never values). Pending device-flow user_code if any. Local.

Start Yandex OAuth device-code flow: returns verification URL + user_code. Uses MCP URL elicitation when the client supports it. Pass client_id or set YANDEX_OAUTH_CLIENT_ID. No token in output.

Poll pending device-code auth; on success write 0600 token files and hot-reload (no restart). Never returns the token. Call after the user confirms in the browser.

Pick Yandex platforms (direct, metrika, webmaster, audience, wordstat, serp, maps, manage) or a preset (direct-only, analytics, seo, everything) and tool_loading eager|lazy -> YANDEX_TOOLSETS + token cost. write=true saves to mcp.local.json (stdio). No secrets.