Skip to main content
Glama
nikolaymokh-dev

vk-ads-mcp

by nikolaymokh-dev
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
VK_ADS_CLIENT_IDNoClient ID for OAuth authentication
VK_ADS_ACCESS_TOKENNoDirect access token (alternative to client_id/secret)
VK_ADS_CLIENT_SECRETNoClient secret for OAuth authentication
VK_ADS_ENABLE_WRITESNoSet to true to enable mutating operationsfalse
VK_ADS_ALLOW_LOCAL_UPLOADNoDirectory path to allow local file uploads from
VK_ADS_ALLOW_BASE_URL_OVERRIDENoAllow overriding the base URL (e.g., for testing)

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_checkA

Verify credentials and API reachability.

Returns current user info if token is valid, otherwise an error payload.

list_campaignsA

List advertising campaigns.

Args: limit: max items (default 50, max 250). offset: pagination offset. status: filter by status (active, blocked, deleted, etc.). fields: comma-separated field list to return.

get_campaignC

Get a single campaign by ID.

list_ad_groupsB

List ad groups, optionally filtered by campaign_id.

get_ad_groupC

Get a single ad group by ID.

list_bannersC

List banners (individual ads).

get_bannerB

Get a single banner by ID.

get_statistics_dayB

Daily statistics.

Args: entity: one of campaigns, ad_groups, banners, users. ids: comma-separated entity IDs (e.g. "123,456"). date_from: YYYY-MM-DD. date_to: YYYY-MM-DD. metrics: optional metric group (e.g. base, video, uniques, all).

get_statistics_summaryC

Summary (aggregated) statistics for the period.

Args mirror get_statistics_day.

list_remarketing_groupsC

List remarketing audiences.

list_packagesA

List available ad packages (ad formats / placements).

search_regionsC

Search geo regions for targeting (cities, regions).

list_contentB

List uploaded content.

Args: content_type: one of static, video, html5. limit, offset: pagination.

list_remarketing_pixelsC

List remarketing pixels (tracking tags).

list_users_listsB

List custom-audience users lists (uploaded phone/email hash segments).

get_lookalikeB

Get a lookalike audience (incl. processing status).

list_feedsC

List product feeds for dynamic/shopping ads.

list_agency_clientsC

List clients managed under an agency account.

get_account_infoA

Get current account info (including balance/budget fields).

get_async_reportC

Get async report status or download link when ready.

get_statistics_breakdownC

Statistics sliced by a dimension.

Args: entity: campaigns | ad_groups | banners. ids: comma-separated IDs. group_by: one of age, gender, region, placement, os, device_type. metrics: metric group.

get_dictionaryA

Fetch an arbitrary VK Ads dictionary.

Examples:

  • name="interests" → /api/v2/interests.json

  • name="browsers" → /api/v2/browsers.json

  • name="currencies" → /api/v2/currencies.json

  • name="sectors" → /api/v2/sectors.json

list_ad_plansC

List ad plans (top-level entity visible as "Кампания" in VK Ads UI).

get_ad_planB

Get a single ad plan by ID.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

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/vk-ads-mcp'

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