vk-ads-mcp

MCP (Model Context Protocol) server for the VK Ads API. Allows AI assistants to manage VK advertising campaigns, ad groups, banners, audiences, and more through a standardized tool interface.

Installation

npx -y vk-ads-mcp

Or install globally:

npm install -g vk-ads-mcp

Configuration

Set the following environment variables:

| Variable | Required | Description | |---|---|---| | VK_ACCESS_TOKEN | Yes | VK Ads API access token | | VK_PROXY_URL | No | API proxy URL (defaults to https://rk.targethunter.ru/vkr.request) |

Claude Desktop

Add to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "vk-ads": {
      "command": "npx",
      "args": ["-y", "vk-ads-mcp"],
      "env": {
        "VK_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

Tools

Account

• vk_get_user -- Get current user/ad account info
• vk_get_throttling -- Get API rate limit info

Ad Plans (Campaigns)

• vk_get_ad_plans -- List campaigns with filtering and pagination
• vk_get_ad_plan -- Get single campaign details by ID
• vk_create_ad_plan -- Create a new campaign
• vk_update_ad_plan -- Update a campaign
• vk_delete_ad_plan -- Delete a campaign
• vk_mass_action_ad_plans -- Bulk start/stop/delete campaigns

Ad Groups

• vk_get_ad_groups -- List ad groups with filtering
• vk_get_ad_group -- Get single ad group details
• vk_create_ad_group -- Create an ad group
• vk_update_ad_group -- Update an ad group
• vk_delete_ad_group -- Delete an ad group
• vk_mass_action_ad_groups -- Bulk start/stop/delete ad groups

Banners (Ads)

• vk_get_banners -- List banners with filtering
• vk_get_banner -- Get single banner details
• vk_create_banner -- Create a banner
• vk_update_banner -- Update a banner
• vk_delete_banner -- Delete a banner
• vk_mass_action_banners -- Bulk start/stop/delete banners

Statistics

• vk_get_statistics -- Get performance stats (impressions, clicks, spend, CTR) for campaigns, ad groups, or banners by day/hour/summary

Remarketing

• vk_get_remarketing_users_lists -- List remarketing audiences
• vk_get_remarketing_users_list -- Get single audience details
• vk_create_remarketing_users_list -- Create an audience (upload emails, phones, VK IDs)
• vk_delete_remarketing_users_list -- Delete an audience
• vk_get_remarketing_counters -- List remarketing pixels
• vk_get_remarketing_counter -- Get single pixel details
• vk_create_remarketing_counter -- Create a remarketing pixel
• vk_delete_remarketing_counter -- Delete a remarketing pixel

Targeting

• vk_get_regions -- List regions for targeting
• vk_get_interests -- List interest categories for targeting
• vk_get_projection -- Estimate audience size for targeting parameters

Agency

• vk_get_agency_clients -- List agency clients
• vk_get_agency_client -- Get single client details
• vk_get_agency_managers -- List agency managers
• vk_get_agency_manager -- Get single manager details

Media

• vk_upload_image -- Upload an image for use in banners

Blacklists

• vk_get_blacklists -- List placement blacklists
• vk_get_blacklist -- Get single blacklist details

License

ISC