Skip to main content
Glama
nikolaymokh-dev

yandex-direct-mcp

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
YANDEX_DIRECT_TOOL_PROFILENoExplicit profile selection: 'analytics', 'core', 'campaign-editor', or 'full'. Overrides ENABLE_WRITES logic.
YANDEX_DIRECT_ENABLED_TOOLSNoComma-separated allow-list of specific tools.
YANDEX_DIRECT_ENABLE_WRITESNoSet to 'true' to activate campaign-editor profile (write operations). Default not set (read-only).
YANDEX_DIRECT_DISABLED_TOOLSNoComma-separated tools to remove from active surface.
YANDEX_DIRECT_ENABLED_GROUPSNoComma-separated allow-list of groups: campaigns, ads, read, mutate, analytics, etc.
YANDEX_DIRECT_ENABLE_FINANCENoSet to 'true' to include financial instruments (requires YANDEX_DIRECT_ENABLE_WRITES=true). Default not set.
YANDEX_DIRECT_DISABLED_GROUPSNoComma-separated groups to remove from active surface.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
auth_statusC

Check the current direct auth profile status (token presence, login, expiry). Call tool_help('auth_status') for parameters.

auth_setupB

Save a ready-made direct OAuth token (y0_...) into a direct auth profile; use auth_login for the interactive browser flow. Call tool_help('auth_setup') for parameters.

auth_loginA

Start interactive OAuth login through direct (elicits the authorization code); use auth_setup if you already have a y0_ token. Call tool_help('auth_login') for parameters.

changes_checkA

Check what changed since a timestamp within specific objects, filtered by exactly one of campaign_ids / ad_group_ids / ad_ids. Use this for targeted checks; use changes_check_campaigns for an account-wide campaign-level scan. Call tool_help('changes_check') for parameters.

changes_check_campaignsA

Check account-wide campaign-level changes since a timestamp (which campaigns changed). Use this for a broad scan; use changes_check to drill into specific campaign/ad-group/ad IDs. Call tool_help('changes_check_campaigns') for parameters.

changes_check_dictionariesB

Check whether Yandex.Direct reference dictionaries (e.g. regions) have changed; takes no parameters. Call tool_help('changes_check_dictionaries') for parameters.

dictionaries_getB

Get reference dictionary data by names (Currencies, GeoRegions, TimeZones, etc.); use dictionaries_list_names to see options. Call tool_help('dictionaries_get') for parameters.

dictionaries_list_namesA

List the dictionary names accepted by dictionaries_get. Call tool_help('dictionaries_list_names') for parameters.

dictionaries_get_geo_regionsC

Get GeoRegions dictionary entries, optionally filtered by name or region IDs. Call tool_help('dictionaries_get_geo_regions') for parameters.

leads_getB

List leads (form submissions) for the given Turbo pages; leads are scoped to Turbo pages, not campaigns. Call tool_help('leads_get') for parameters.

reports_getA

Quick per-campaign performance snapshot over a short recent window (~last 8 days, default fields). Use reports_get for a fast overview; use reports_custom for arbitrary fields, filters, or date/goal breakdowns. Call tool_help('reports_get') for parameters.

reports_list_typesA

List supported Yandex.Direct report types with guidance on when to pick each (use before reports_custom if unsure which report_type fits). Call tool_help('reports_list_types') for parameters.

reports_customA

Build an arbitrary Yandex.Direct statistics report: any FieldNames, filters, ordering, date/week/month/goal breakdowns, pagination, and file output. Use reports_custom for arbitrary fields & breakdowns; use reports_get for a quick recent snapshot. Call tool_help('reports_custom') for parameters.

keywordsresearch_has_search_volumeC

Check whether keywords have search volume in given regions. Call tool_help('keywordsresearch_has_search_volume') for parameters.

keywordsresearch_deduplicateC

Deduplicate a list of keywords. Call tool_help('keywordsresearch_deduplicate') for parameters.

tool_helpA

Get the full documentation for another tool: parameter reference, examples and constraints. Call this BEFORE using an unfamiliar tool — the tools themselves carry only a one-line summary. Pass the exact tool name (e.g. 'campaigns_add'); omit the name to list every available tool.

v4events_get_events_logC

Get v4 Live events log entries via GetEventsLog for a timestamp range. Call tool_help('v4events_get_events_log') for parameters.

v4forecast_createC

Create a v4 Live budget forecast via CreateNewForecast (up to 100 phrases). Call tool_help('v4forecast_create') for parameters.

v4forecast_listA

List v4 Live budget forecasts via GetForecastList. Call tool_help('v4forecast_list') for parameters.

v4forecast_getC

Get a ready v4 Live budget forecast by ID via GetForecast. Call tool_help('v4forecast_get') for parameters.

v4goals_get_stat_goalsB

Get Yandex Metrica stat goals available for campaigns (v4 Live); use v4goals_get_retargeting_goals for retargeting goals. Call tool_help('v4goals_get_stat_goals') for parameters.

v4goals_get_retargeting_goalsB

Get retargeting goals for campaigns (v4 Live); use v4goals_get_stat_goals for Metrica stat goals. Call tool_help('v4goals_get_retargeting_goals') for parameters.

v4keywords_get_suggestionA

Get related keyword suggestions via v4 Live GetKeywordsSuggestion (up to 20 phrases; spends API points). Call tool_help('v4keywords_get_suggestion') for parameters.

v4wordstat_create_reportB

Create a v4 Live Wordstat report via CreateNewWordstatReport (up to 10 phrases). Call tool_help('v4wordstat_create_report') for parameters.

v4wordstat_list_reportsC

List v4 Live Wordstat reports via GetWordstatReportList. Call tool_help('v4wordstat_list_reports') for parameters.

v4wordstat_get_reportC

Get a ready v4 Live Wordstat report by ID via GetWordstatReport. Call tool_help('v4wordstat_get_report') for parameters.

Prompts

Interactive templates invoked by user choice

NameDescription
oauth_loginЗапустить OAuth авторизацию через `direct`

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nikolaymokh-dev/yandex-direct-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server