Avito Ads MCP

A1 Avito Ads MCP connects an AI app to your Avito Ads advertising account. It helps you review campaigns and statistics, manage a group's budget and bid, and work with agency balances, access rights, and ORD documents — in natural language.

This is not the Avito seller API: the server does not work with items, messaging, orders, or seller ad promotion. It works only with display and performance campaigns in the Avito Ads advertising account.

• 25 tools. Campaigns, groups, creatives, statistics, balance, child accounts, users, and ORD documents.

• Narrow campaign changes. The API only allows changing a group's budget and bid; you cannot create, edit, pause, or delete campaigns, groups, or creatives.

• Irreversible operations are visible. Money or bonus transfers, user deletion, and raw API requests are marked as destructive.

• Weekly API budget. Every call spends points; the server returns the apiPointBalance remaining with each result.

Start with a request that only reads data:

Show me the campaigns in my Avito account and last week's spend by ad group.

Connect the server · See scenarios · Open technical documentation

See it work in a minute

You: Show me the campaigns in my Avito account and last week's spend by ad group.

Assistant: Shows campaigns, groups, spend, clicks, and impressions. Nothing changes.

You: Prepare a bid change for group 101 to 350 rubles.

Assistant: Shows the account, group, current and new bid, then asks for confirmation.

You: Confirmed.

Assistant: Changes the bid for that group only. The campaign, creatives, and other groups are unchanged.

Related MCP server: VK Ads MCP

Contents

• Quick start

• What you can delegate

• What can change

• Getting access

• Configuration

• Data, limits, and background work

• Technical documentation

• Support

Quick start

You need Node.js 20+, a Client Key, a Client Secret, and the Avito Ads advertising account ID. An account administrator role is required to issue access.

1. Get access.

2. Add the server to your AI app.

3. Send the safe first request above.

In Settings → Plugins → MCP servers, click Add server, then add npx -y mcp-avito-ads@latest with AVITO_ADS_CLIENT_ID, AVITO_ADS_CLIENT_SECRET, and AVITO_ADS_ACCOUNT_ID.

codex mcp add avito-ads \
  --env AVITO_ADS_CLIENT_ID=your_client_key \
  --env AVITO_ADS_CLIENT_SECRET=your_client_secret \
  --env AVITO_ADS_ACCOUNT_ID=your_account_id \
  -- npx -y mcp-avito-ads@latest
codex mcp list

Codex MCP documentation

claude mcp add \
  --env AVITO_ADS_CLIENT_ID=your_client_key \
  --env AVITO_ADS_CLIENT_SECRET=your_client_secret \
  --env AVITO_ADS_ACCOUNT_ID=your_account_id \
  --transport stdio --scope user avito-ads \
  -- npx -y mcp-avito-ads@latest
claude mcp list

Claude Code MCP documentation

Open Settings → Developer → Edit Config and add:

{"mcpServers":{"avito-ads":{"command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"your_client_key","AVITO_ADS_CLIENT_SECRET":"your_client_secret","AVITO_ADS_ACCOUNT_ID":"your_account_id"}}}}

If Edit Config is unavailable, edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows. Claude Desktop MCP documentation

Add {"mcpServers":{"avito-ads":{"type":"stdio","command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"your_client_key","AVITO_ADS_CLIENT_SECRET":"your_client_secret","AVITO_ADS_ACCOUNT_ID":"your_account_id"}}}} to ~/.cursor/mcp.json on macOS/Linux or %USERPROFILE%\.cursor\mcp.json on Windows. Cursor MCP documentation

Run MCP: Open User Configuration and add:

{"servers":{"avito-ads":{"type":"stdio","command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"${input:avito_client_id}","AVITO_ADS_CLIENT_SECRET":"${input:avito_client_secret}","AVITO_ADS_ACCOUNT_ID":"${input:avito_account_id}"}}},"inputs":[{"type":"promptString","id":"avito_client_id","description":"Avito Ads Client Key"},{"type":"promptString","id":"avito_client_secret","description":"Avito Ads Client Secret","password":true},{"type":"promptString","id":"avito_account_id","description":"ID рекламного аккаунта"}]}

Check the server with the MCP: List Servers command. VS Code MCP documentation

What you can delegate

• Show campaigns, groups, creatives, statuses, and statistics for a period.

• Compare spend, CTR, CPM, CPC, or VTR across groups and creatives.

• Check the balance and child accounts of the agency.

• Prepare a budget or bid change for a single group.

• Create an advertiser and an ORD contract, first showing the details being sent.

• Add a user, change their role, or revoke access after confirmation.

What can change

Campaigns, groups, and creatives cannot be created, edited, paused, archived, or deleted through this API. Creatives and targeting are also not writable.

Getting access

1. Open the Avito Ads account as a user with the administrator role.

2. Create an API app and copy the Client Key and Client Secret.

3. Copy the advertising account ID.

4. Pass them as AVITO_ADS_CLIENT_ID, AVITO_ADS_CLIENT_SECRET, AVITO_ADS_ACCOUNT_ID.

The server obtains a Bearer token via OAuth2 client_credentials. Store the Client Secret like a password. The account ID is set by configuration: tools cannot accidentally switch to another account.

To rehearse writes, you can set AVITO_ADS_ENVIRONMENT=sandbox. The sandbox is not a full copy of production: for example, the balance is unavailable there.

Configuration

Data, limits, and background work

• Weekly point budget. Points are refilled on Monday at 00:00 UTC. One long report of up to 100 days is usually more economical than a series of short ones; the server shows apiPointBalance with every result.

• Transient errors. On 429, the error returns Retry-After and the remaining points. Writes are not retried after a network or 5xx error, so money is not transferred twice.

• No continuous monitoring. The server only runs when called. If the AI app supports scheduled jobs, it can periodically collect statistics and the point balance.

• Anonymous telemetry. It never includes secrets, account data, arguments, or prompts; disable with ASKADS_TELEMETRY=0.

Technical documentation

• MCP capabilities catalog — pages by user task for each tool.

• All tools and parameters

• Development documentation

• Publishing documentation

• Official Avito Ads SDK

Support

Found a bug or missing a scenario? Create an issue or write to Telegram.