How do I use mcp-yandex-direct?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-yandex-direct list my active campaigns" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-yandex-direct

by gistrec

Overview Schema Related Servers Score Discussions

TypeScript

Remote

mcp-yandex-direct

An MCP server for the Yandex Direct API v5. It lets MCP-compatible clients (Claude Desktop, Claude Code, etc.) manage PPC campaigns, ad groups, ads and keywords, and pull performance statistics.

This is an original, from-scratch implementation released under the MIT license.

Tools

Tool	Description
`get_account_info`	Account details: login, currency, type, country.
`list_campaigns`	List campaigns with filters (id, type, state, status).
`create_text_campaign`	Create a TextCampaign.
`campaign_action`	suspend / resume / archive / unarchive / delete campaigns.
`list_ad_groups`	List ad groups by campaign or id.
`create_ad_group`	Create an ad group with target geo.
`list_ads`	List ads with filters.
`create_text_ad`	Create a text ad (starts as draft).
`ad_action`	moderate / suspend / resume / archive / unarchive / delete ads.
`list_keywords`	List keywords by campaign, ad group or id.
`add_keywords`	Add keywords with optional search/network bids.
`keyword_action`	suspend / resume / delete keywords.
`get_statistics`	TSV performance report via the Reports service.

Monetary inputs (budgets, bids) are given in account currency units and converted to micros automatically.

Related MCP server: Meta Ads MCP Server

Requirements

Node.js 18+
A Yandex Direct OAuth token (how to get one)

Setup

npm install
npm run build

Configuration

The server is configured through environment variables:

Variable	Required	Default	Description
`YANDEX_DIRECT_TOKEN`	yes	—	OAuth token for the Yandex Direct API.
`YANDEX_DIRECT_LOGIN`	no	—	`Client-Login` header (agency accounts only).
`YANDEX_DIRECT_LANG`	no	`ru`	`Accept-Language` for API responses (`ru`, `en`, `uk`, `tr`).
`YANDEX_DIRECT_SANDBOX`	no	`false`	Set to `true` to target the API sandbox.

Tip: start with YANDEX_DIRECT_SANDBOX=true to experiment safely before touching live campaigns.

Usage with an MCP client

Copy .mcp.json.example to your client configuration (e.g. .mcp.json), set your token, and point args at the built entry point:

{
  "mcpServers": {
    "yandex-direct": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-yandex-direct/dist/index.js"],
      "env": {
        "YANDEX_DIRECT_TOKEN": "your-oauth-token",
        "YANDEX_DIRECT_SANDBOX": "true"
      }
    }
  }
}

Development

npm run dev    # run from source with tsx watch
npm test       # run unit tests
npm run build  # type-check and emit dist/

License

MIT — see LICENSE.

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

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/gistrec/mcp-yandex-direct'

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