Installs the server avito-mcp-ru: 64 methods of the official API
(40 read, 22 write, 2 irreversible). The method catalog lives in YAML and
is executed by the server, so the agent gets several universal
tools rather than a separate function for each method.
Installation
The first release on PyPI is published with the tag v0.5.3, before that the package is installed directly from the repository:
uvx --from git+https://github.com/ilyautov/avito-mcp-ru avito-mcp-ru
After the release the line is shorter:
uvx avito-mcp-ru
Client configuration (Claude Desktop, Cursor, Claude Code):
{
"mcpServers": {
"avito": {
"command": "uvx",
"args": ["--from", "git+https://github.com/ilyautov/avito-mcp-ru", "avito-mcp-ru"],
"env": {
"AVITO_CLIENT_ID": "<значение>",
"AVITO_CLIENT_SECRET": "<значение>"
}
}
}
}
Where to get the keys
AVITO_CLIENT_ID: client_id from the For business section → Integrations → API.AVITO_CLIENT_SECRET: client_secret from the same place, exchanged for a token via OAuth2.
The second path, without environment variables: start the server and call
avito_add_cabinet. The keys will land in ~/.marketplace-mcp/cabinets.json
with permissions 600 and do not leave the machine. A second store is connected the same way.
What to ask the server
avito_search_methods("остатки по складам"): search for a method by words.avito_describe_method(...): parameters, pagination, access class.avito_call_method(...): call. Reading goes through immediately, writing asks for confirmation, irreversible asks twice.avito_check_auth: check that the keys got through.
How to behave
First look up the method with the catalog, do not guess the name. Before writing, show the person what exactly will go to the API, and wait for consent: the gate will trigger anyway, but the person must see the request body before, not after.
Do not round the numbers from the response or recalculate them in your head. If the method returned an empty list, say so, instead of explaining it on the seller's behalf.
All four marketplaces at once
If you need not only Avito, the combine is installed marketplaces-mcp-ru:
Wildberries, Ozon, Yandex Market and Avito in one server.