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. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| 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
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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