Local MCP server that exposes Avito’s public APIs as tools so an AI agent can manage listings, chats, orders, promotions, delivery, and account data on Avito. It runs over stdio locally and uses OAuth credentials from Avito to access the account.
From the registry: Avito API MCP for autonomous AI agents to operate an account hands-free - not a scraper.
Please install the `avito-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js** — Node.js is required to run the server via npx. (https://nodejs.org/)
- **Create Avito OAuth credentials** — Get your Avito OAuth credentials from the Avito Developer Portal: Client_id, Client_secret, and Profile_id (your numeric account ID). (https://www.avito.ru/professionals/api)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","avito-mcp"]
- required environment variables:
- `Client_id`: Avito OAuth client ID from the Avito Developer Portal. (example: `<your-client-id>`)
- `Client_secret`: Avito OAuth client secret from the Avito Developer Portal. (example: `<your-client-secret>`)
- `Profile_id`: Your Avito numeric account/profile ID. (example: `<your-profile-id>`)
- optional environment variables:
- `AVITO_MCP_MODE`: Tool exposure mode. Supported values include read_only, guarded, and full_access. (example: `<read_only|guarded|full_access>`)
- `AVITO_MCP_EXPOSE_AUTH_TOOLS`: Set to 1 to expose sensitive auth_* tools that return OAuth tokens. (example: `<1>`)
- `AVITO_MCP_ALLOWED_UPLOAD_DIRS`: Allowlist of local directories for messenger_upload_images. Without this, the upload tool is not registered. (example: `<allowed-upload-directories>`)
- `AVITO_MCP_CONFIRMATION_MODE`: Confirmation policy for destructive actions. Supported values include off, money_public, and all_destructive. (example: `<off|money_public|all_destructive>`)
- `AVITO_MCP_DRY_RUN_DEFAULT`: If true, destructive tools default to dry-run mode unless explicitly overridden. (example: `<true>`)
- `AVITO_MCP_IDEMPOTENCY_TTL_SEC`: TTL in seconds for idempotency key replay protection. (example: `<ttl-seconds>`)
- `AVITO_MCP_TOKEN_LOCK_TIMEOUT_MS`: Timeout in milliseconds for the cross-process token refresh lock. (example: `<timeout-ms>`)
- `AVITO_TOKEN_FILE`: Override the path to the cached OAuth token file. (example: `<path-to-token-file>`)
- `AVITO_MCP_ALLOW_TOOLS`: Allowlist of tool names to expose. (example: `<comma-separated-tool-names>`)
- `AVITO_MCP_DENY_TOOLS`: Denylist of tool names to hide. Deny wins over allow. (example: `<comma-separated-tool-names>`)
- `AVITO_MCP_MAX_UPLOAD_MB`: Maximum allowed upload size in megabytes for image uploads. (example: `<max-upload-mb>`)
Note: Preferred install path is the portable npx-based stdio server. The README states the universal MCP parameters are command=npx, args=["-y","avito-mcp"], env={Client_id, Client_secret, Profile_id}. Source install is available but not preferred.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Client_idrequiredAvito OAuth client ID used to authenticate the serverClient_secretrequiredAvito OAuth client secret used to authenticate the serverProfile_idrequiredNumeric Avito profile/account ID used to access the accountMeta Ads MCP (Facebook + Instagram) - analyze performance, manage budgets, pause campaigns.