Returns information about the current VK Ads account (user.json), including additional_info.client_name. Use it to confirm which advertiser account the token points at.

Returns the current VK Ads account balance: available funds and currency. Calls user.json with the account field, which carries the wallet (account.balance, account.currency). Reports the balance of the account the token points at (no parameters). Note: the exact balance field name in v3/user.json on the new ads.vk.com platform is not confirmed against a live cabinet (the domain is JS-gated); the schema follows the myTarget/VK Ads object model (v2/v3). This tool returns the RAW VK response unchanged, so a caller can read account.balance defensively regardless of the exact shape — verify on the first live account with read_payments.

Returns the current VK Ads request limits and remaining budget (throttling.json), so you can avoid hitting the rate limit.

Lists VK Ads geo regions (id, name, type), optionally filtered by a name substring. Region ids are needed for ad group geo targeting.

Lists ad plans (the top-level VK Ads campaign object) with optional filtering by id and status. Money fields (budget_limit, budget_limit_day, max_price) are in the account currency.

Creates an ad plan (campaign). Money fields are in account currency. Pass complex or less common fields via extra (merged into the request body verbatim).

Updates an ad plan's name, budgets, bid cap or dates. Money fields are in account currency. Use ad_plan_action to change status.

Changes the lifecycle status of ad plans by id: activate (status=active), stop (status=blocked) or delete (status=deleted).

Lists ad groups with optional filtering by id, parent ad plan and status. Money fields are in the account currency; targetings holds the geo/demographic/interest targeting structure.

Creates an ad group inside an ad plan. Targeting goes in targetings (e.g. {"geo":{"regions":[188]},"age":{"age_list":[25,26]}}). Money fields are in account currency. Use extra for any other field.

Updates an ad group's name, budgets, bid cap, dates or targeting. Money fields are in account currency. Use ad_group_action to change status.

Changes the lifecycle status of ad groups by id: activate (status=active), stop (status=blocked) or delete (status=deleted).

Lists banners (the VK Ads creative/ad object) with optional filtering by id, parent ad group and status. moderation_status (pending/allowed/banned) and delivery show why an ad is or isn't showing.

Creates a banner inside an ad group. Creative content references uploaded media via content, ad copy goes in textblocks and links in urls. These structures are sent verbatim; consult the VK Ads docs for the exact shape per ad format.

Updates a banner's name, text blocks or links. Use banner_action to change status. Structures are sent verbatim.

Changes the lifecycle status of banners by id: activate (status=active), stop (status=blocked) or delete (status=deleted).

Fetches performance statistics from the VK Ads v3 statistics service for ad plans, ad groups or banners. By default the grouping is summary — one aggregated row per object over the whole period; use day/week/month ONLY for daily dynamics or trend questions (each adds a row per object per period). Rank objects server-side with sortBy (e.g. base.spent) + order; the response also carries total — the summary across ALL objects for the period (use it for «сколько всего», no need to sum rows). Metrics live under base (shows, clicks, spent, ...); spent is in account currency.

Escape hatch to call any VK Ads API endpoint directly (e.g. path "v2/ad_plans.json", method GET). Use this for endpoints that have no dedicated tool. query becomes the query string; body is sent as JSON for POST. GET runs freely; POST and DELETE are writes and require confirmWrite=true.