avito-mcp — Claude Code MCP server: Avito chats and listings
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.
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-mcpWhat avito-mcp 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.
What it helps with
- 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 for the agent
- 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
How to install avito-mcp
Platform CLI
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-mcpReplace <…> with your own values
Platform CLI
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-mcpReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
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-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about avito-mcp
How do I install avito-mcp in Claude Code?
Run claude mcp add avito-mcp -e Client_id=<Client_id> -e Client_secret=<Client_secret> -e Profile_id=<Profile_id> -- npx -y avito-mcp with your own credentials filled in.
What does avito-mcp do?
It gives an AI client tools to work with an Avito account: chats, listings, statistics, promotion and orders. Destructive actions go through a preview and a confirmation step.
Can I try it without Avito credentials?
Yes. Starting with --demo serves fictional data locally and makes no calls to Avito, so no API keys are involved.
