Skip to content
MCP server

Avito Ads MCP

MCP server for the Avito Ads API: campaigns, ad groups, creatives, statistics and…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.3.1
Listing updated
4 days ago

About Avito Ads MCP

Avito Ads MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

MCP server for the Avito Ads API: campaigns, ad groups, creatives, statistics and balances.

Install

Run in a terminal

claude mcp add mcp-avito-ads --env AVITO_ADS_CLIENT_ID='<AVITO_ADS_CLIENT_ID>' --env AVITO_ADS_CLIENT_SECRET='<AVITO_ADS_CLIENT_SECRET>' --env AVITO_ADS_ACCOUNT_ID='<AVITO_ADS_ACCOUNT_ID>' -- npx -y mcp-avito-ads

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-avito-ads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-avito-ads"
      ],
      "env": {
        "AVITO_ADS_CLIENT_ID": "<AVITO_ADS_CLIENT_ID>",
        "AVITO_ADS_CLIENT_SECRET": "<AVITO_ADS_CLIENT_SECRET>",
        "AVITO_ADS_ACCOUNT_ID": "<AVITO_ADS_ACCOUNT_ID>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-avito-ads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-avito-ads"
      ],
      "env": {
        "AVITO_ADS_CLIENT_ID": "<AVITO_ADS_CLIENT_ID>",
        "AVITO_ADS_CLIENT_SECRET": "<AVITO_ADS_CLIENT_SECRET>",
        "AVITO_ADS_ACCOUNT_ID": "<AVITO_ADS_ACCOUNT_ID>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-avito-ads": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-avito-ads"
      ],
      "env": {
        "AVITO_ADS_CLIENT_ID": "<AVITO_ADS_CLIENT_ID>",
        "AVITO_ADS_CLIENT_SECRET": "<AVITO_ADS_CLIENT_SECRET>",
        "AVITO_ADS_ACCOUNT_ID": "<AVITO_ADS_ACCOUNT_ID>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-avito-ads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-avito-ads"
      ],
      "env": {
        "AVITO_ADS_CLIENT_ID": "<AVITO_ADS_CLIENT_ID>",
        "AVITO_ADS_CLIENT_SECRET": "<AVITO_ADS_CLIENT_SECRET>",
        "AVITO_ADS_ACCOUNT_ID": "<AVITO_ADS_ACCOUNT_ID>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-avito-ads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-avito-ads"
      ],
      "env": {
        "AVITO_ADS_CLIENT_ID": "<AVITO_ADS_CLIENT_ID>",
        "AVITO_ADS_CLIENT_SECRET": "<AVITO_ADS_CLIENT_SECRET>",
        "AVITO_ADS_ACCOUNT_ID": "<AVITO_ADS_ACCOUNT_ID>"
      }
    }
  }
}

Configuration

  • AVITO_ADS_CLIENT_IDOAuth2 client id of your Avito application (grant_type=client_credentials).Required
  • AVITO_ADS_CLIENT_SECRETOAuth2 client secret of your Avito application. Treat it as a secret.Required
  • AVITO_ADS_ACCOUNT_IDAd account id (positive integer) every request is scoped to.Required
  • AVITO_ADS_ENVIRONMENTWhich API to talk to: production or sandbox.
  • AVITO_ADS_API_BASEAPI root override, replacing host and environment prefix (e.g. a local mock).
  • AVITO_ADS_TIMEOUT_MSPer-request timeout in milliseconds.
  • AVITO_ADS_MAX_RETRIESRetries on 429 (always) and on 5xx / network errors for reads only.
  • AVITO_ADS_TOKEN_LEEWAY_SECONDSRefresh the OAuth2 token this many seconds before it expires.

Pricing

Open source

Avito Ads MCP FAQ

Is Avito Ads MCP free?

Yes. Avito Ads MCP is open source, so you can use and self-host it for free.

How do I add Avito Ads MCP to Claude Code?

Run this command in your terminal: claude mcp add mcp-avito-ads --env AVITO_ADS_CLIENT_ID='<AVITO_ADS_CLIENT_ID>' --env AVITO_ADS_CLIENT_SECRET='<AVITO_ADS_CLIENT_SECRET>' --env AVITO_ADS_ACCOUNT_ID='<AVITO_ADS_ACCOUNT_ID>' -- npx -y mcp-avito-ads