Avito Ads MCP Server

by a1-x-techio.github.A1-x-Tech/mcp-avito-adsv1.2.0

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

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active5d ago

Install Avito Ads MCP server

claude mcp add avito-ads -e AVITO_ADS_CLIENT_ID='<avito-ads-client-id>' -e AVITO_ADS_CLIENT_SECRET='<avito-ads-client-secret>' -e AVITO_ADS_ACCOUNT_ID='<avito-ads-account-id>' -- npx -y mcp-avito-ads

{
  "mcpServers": {
    "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 (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "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>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "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 .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "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 ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
AVITO_ADS_CLIENT_ID	yes	yes	OAuth2 client id of your Avito application (grant_type=client_credentials).
AVITO_ADS_CLIENT_SECRET	yes	yes	OAuth2 client secret of your Avito application. Treat it as a secret.
AVITO_ADS_ACCOUNT_ID	yes	—	Ad account id (positive integer) every request is scoped to.
AVITO_ADS_ENVIRONMENT	—	—	Which API to talk to: production or sandbox.
AVITO_ADS_API_BASE	—	—	API root override, replacing host and environment prefix (e.g. a local mock).
AVITO_ADS_TIMEOUT_MS	—	—	Per-request timeout in milliseconds.
AVITO_ADS_MAX_RETRIES	—	—	Retries on 429 (always) and on 5xx / network errors for reads only.
AVITO_ADS_TOKEN_LEEWAY_SECONDS	—	—	Refresh the OAuth2 token this many seconds before it expires.

Freshness

Active — last maintenance signal 5d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-04 · 5d ago · GitHub
Latest release
2026-09-20 · 19d ago · GitHub · v1.2.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-20 · 19d ago · official registry · v1.2.0

FAQ

›How do I install the Avito Ads MCP server in Claude Code?

Run: claude mcp add avito-ads -e AVITO_ADS_CLIENT_ID='<avito-ads-client-id>' -e AVITO_ADS_CLIENT_SECRET='<avito-ads-client-secret>' -e AVITO_ADS_ACCOUNT_ID='<avito-ads-account-id>' -- npx -y mcp-avito-ads. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Avito Ads require an API key?

Yes. It expects AVITO_ADS_CLIENT_ID, AVITO_ADS_CLIENT_SECRET, AVITO_ADS_ACCOUNT_ID, of which 2 are secrets.

›Can I use Avito Ads as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Avito Ads in the official MCP registry?

Yes, as io.github.A1-x-Tech/mcp-avito-ads.