yandex-direct-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YANDEX_DIRECT_TOOL_PROFILE | No | Explicit profile selection: 'analytics', 'core', 'campaign-editor', or 'full'. Overrides ENABLE_WRITES logic. | |
| YANDEX_DIRECT_ENABLED_TOOLS | No | Comma-separated allow-list of specific tools. | |
| YANDEX_DIRECT_ENABLE_WRITES | No | Set to 'true' to activate campaign-editor profile (write operations). Default not set (read-only). | |
| YANDEX_DIRECT_DISABLED_TOOLS | No | Comma-separated tools to remove from active surface. | |
| YANDEX_DIRECT_ENABLED_GROUPS | No | Comma-separated allow-list of groups: campaigns, ads, read, mutate, analytics, etc. | |
| YANDEX_DIRECT_ENABLE_FINANCE | No | Set to 'true' to include financial instruments (requires YANDEX_DIRECT_ENABLE_WRITES=true). Default not set. | |
| YANDEX_DIRECT_DISABLED_GROUPS | No | Comma-separated groups to remove from active surface. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
| oauth_login | Запустить OAuth авторизацию через `direct` |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
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