# avito-mcp

Bridges an Avito seller account into an AI client so it can read chats and stats, draft replies, change prices and handle orders. Saves the manual clicking around the seller dashboard.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 23
- Author: elchin92
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/elchin92/avito-mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/avito-mcp

## What it does

The server maps Avito's official APIs onto agent tools. Its README claims 148 tools spread over 18 APIs, covering buyer conversations, listings, statistics, promotion and orders. Your client supplies the model; the server supplies the connection. It runs on your own machine or server through `npx`.

You need `Client_id`, `Client_secret` and a numeric `Profile_id` from the Avito API account page, plus Node.js 22.12 or newer. Which API methods you get depends on the access level of your account: adding the server grants nothing extra on Avito's side.

Writes are staged. The server shows a preview of the pending action and waits for confirmation before touching the account. A `read_only` mode exists, yet `full_access` is what you get unless you set it otherwise, so a first test run deserves that setting. Auto-replies and scheduled reports are not built in: they need an agent or scheduler wired up separately.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `Client_id`, `Client_secret`, `Profile_id`, `AVITO_MCP_PROTOCOL_ERA` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env Client_id=<Client_id> --env Client_secret=<Client_secret> --env Profile_id=<Profile_id> --env AVITO_MCP_PROTOCOL_ERA=<AVITO_MCP_PROTOCOL_ERA> --transport stdio avito-mcp -- npx -y avito-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add avito-mcp --env Client_id=<Client_id> --env Client_secret=<Client_secret> --env Profile_id=<Profile_id> --env AVITO_MCP_PROTOCOL_ERA=<AVITO_MCP_PROTOCOL_ERA> -- npx -y avito-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "avito-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "avito-mcp"
            ],
            "env": {
                "Client_id": "<Client_id>",
                "Client_secret": "<Client_secret>",
                "Profile_id": "<Profile_id>",
                "AVITO_MCP_PROTOCOL_ERA": "<AVITO_MCP_PROTOCOL_ERA>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "avito-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "avito-mcp"
            ],
            "env": {
                "Client_id": "<Client_id>",
                "Client_secret": "<Client_secret>",
                "Profile_id": "<Profile_id>",
                "AVITO_MCP_PROTOCOL_ERA": "<AVITO_MCP_PROTOCOL_ERA>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e Client_id=<Client_id> -e Client_secret=<Client_secret> -e Profile_id=<Profile_id> -e AVITO_MCP_PROTOCOL_ERA=<AVITO_MCP_PROTOCOL_ERA> avito-mcp npx -y avito-mcp
```
Replace <…> with your own values

## When to use it
- triage unread buyer chats and draft replies
- check account balance and listing activity for a period
- reprice a listing with a preview before confirming
- review promotion spending by source
- track an order from request to result

## Example prompts
- Show my Avito balance and the first page of active listings, change nothing
- Go through unread chats and prepare draft replies
- Prepare a price change for one listing and show me the preview before I confirm

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md