# Авито MCP (RU) (pypi · avito-mcp-ru)

API Авито в ИИ-ассистенте: объявления, чаты, заказы, автозагрузка, отзывы

- Trust score: 67/100 (medium)
- Change this week: +16
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-20

## Components

- pypi · `avito-mcp-ru`: 67/100 (this document), [markdown](https://verifymcp.io/servers/ilyautov-avito-mcp-ru/avito-mcp-ru.md), [page](https://verifymcp.io/servers/ilyautov-avito-mcp-ru/avito-mcp-ru)

## Channel facts

- Registry: `pypi`
- Package: `avito-mcp-ru`
- Version: `0.6.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-20.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - Runs setuptools.build_meta at install time, a recognised native-build step with no shell scripting around it.
  - 0 of 31 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 32/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - License check failed: no license is declared.
  - Actively maintained (last published 5 days ago).
  - Security-disclosure policy not yet verified: we couldn't inspect the source repository.
- **Schema Quality & AI Usability**: 72/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 3528 tokens (~117/item across 30 items; 30 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 19/100
  - Stability check failed: the tool surface changed between 0.5.4 and 0.6.0: 1 tool removals, 0 breaking changes, 5 additions.
- **Tool Coverage**: 71/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 0% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 95/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 4 of 5 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "avito_call_method" implies "execute" and declares readOnlyHint instead, contradicting what its own name says it does.
  - An AI judge read all 30 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the Авито MCP (RU) server?

Авито MCP (RU) runs locally as a PyPI package, launched with uvx avito-mcp-ru. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add ilyautov-avito-mcp-ru -- uvx avito-mcp-ru
```

### Cursor

```json
{
  "mcpServers": {
    "ilyautov-avito-mcp-ru": {
      "command": "uvx",
      "args": [
        "avito-mcp-ru"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "ilyautov-avito-mcp-ru": {
      "command": "uvx",
      "args": [
        "avito-mcp-ru"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add ilyautov-avito-mcp-ru -- uvx avito-mcp-ru
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ilyautov-avito-mcp-ru": {
      "type": "local",
      "command": [
        "uvx",
        "avito-mcp-ru"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add ilyautov-avito-mcp-ru --command uvx --arg avito-mcp-ru
```

### Hermes

```yaml
mcp_servers:
  ilyautov-avito-mcp-ru:
    command: "uvx"
    args: ["avito-mcp-ru"]
```

### Netclaw

```json
{
  "McpServers": {
    "ilyautov-avito-mcp-ru": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "avito-mcp-ru"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add ilyautov-avito-mcp-ru -t stdio -c uvx -a avito-mcp-ru
```

### Other

```json
{
  "mcpServers": {
    "ilyautov-avito-mcp-ru": {
      "command": "uvx",
      "args": [
        "avito-mcp-ru"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-20 (score 67, 0)

- [functional regression] Security disclosure: fail → unverified

### 2026-09-18 (score 67, +1)

No change was recorded against any check on this day. Stability & Change Management went from 9 to 13.

### 2026-09-16 (score 66, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 6.

### 2026-09-14 (score 65, +14)

- [security regression] Stability: unverified → fail
- [security regression] Tool safety: pass → unverified
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- [functional regression] Schema quality: 2878 → 3528
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional] First check of Schema quality: unverified
- [functional] Schema quality: excellent → good
- [functional] Destructive annotations: 4 of 5 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "avito_call_method" implies "execute" and declares readOnlyHint instead, contradicting what its own name says it does.
- [functional] Package version: 0.5.4 → 0.6.0

### 2026-09-13 (score 51)

First indexed and scored.

## MCP tools (30)

### `avito_check_auth` (~55 tokens)

Check whether the required credentials are present in the environment.

Does NOT reveal secret values — only reports which variables are set.
Returns JSON: {"ready": bool, "missing": [str], "required": [str]}.

Output parameters:

- `result` (string)

### `avito_list_sections` (~21 tokens)

List API sections and how many catalog endpoints each contains.

Output parameters:

- `result` (string)

### `avito_get_section` (~60 tokens)

List all endpoints in one section.

Args:
    section: section name (see avito_list_sections), e.g. "statistics".
Returns JSON list of {operation_id, method, path, safety, summary}.

Input parameters:

- `section` (string, required)

Output parameters:

- `result` (string)

### `avito_search_methods` (~79 tokens)

Search the endpoint catalog by keyword (works in Russian and English).

Args:
    query: free text, e.g. "остатки", "stocks", "update price".
    limit: max results (1-50).
Returns JSON list of matching endpoints (best first).

Input parameters:

- `limit` (integer)
- `query` (string, required)

Output parameters:

- `result` (string)

### `avito_map` (~82 tokens)

The big picture: business entities this API covers and the go-to
methods for each. Call with no args to see the whole map ("you are
here"); pass entity="reviews" (or stocks/prices/orders/…) to list every
method of one entity. Use this before guessing — it orients you fast.

Input parameters:

- `entity` (string)

Output parameters:

- `result` (string)

### `avito_describe_method` (~50 tokens)

Return the full catalog record for one endpoint: method, host, path,
scope, safety level, pagination style, rate limit, params and doc URL.

Input parameters:

- `operation_id` (string, required)

Output parameters:

- `result` (string)

### `avito_call_method` (~160 tokens)

Execute one READ endpoint from the catalog by operation_id.

Target API: https://developers.avito.ru/api-catalog.

Reads only: nothing here changes data, so it runs without confirmation.
To change data use avito_write_method, to delete use avito_delete_method.

Args:
    operation_id: id from the catalog (see avito_search_methods).
    path_values: values for {placeholders} in the path.
    query: query-string parameters.
    body: JSON request body (a few read endpoints take one).
Returns JSON: {"ok": true, "status", "data"} or the error envelope.

Input parameters:

- `body`
- `operation_id` (string, required)
- `path_values`
- `query`

Output parameters:

- `result` (string)

### `avito_write_method` (~170 tokens)

Execute one WRITE endpoint from the catalog: create or update data.

Target API: https://developers.avito.ru/api-catalog.

Requires confirm_write=true; nothing is sent without it. Irreversible
operations live in avito_delete_method, reads in avito_call_method.

Args:
    operation_id: id from the catalog (see avito_search_methods).
    path_values: values for {placeholders} in the path.
    query: query-string parameters.
    body: JSON request body.
    confirm_write: must be true.
Returns JSON: {"ok": true, "status", "data"} or the error envelope.

Input parameters:

- `body`
- `confirm_write` (boolean)
- `operation_id` (string, required)
- `path_values`
- `query`

Output parameters:

- `result` (string)

### `avito_delete_method` (~191 tokens)

Execute one DESTRUCTIVE endpoint: deletes or irreversibly changes data.

Target API: https://developers.avito.ru/api-catalog.

Both confirm_write=true and i_understand_this_modifies_data=true are
required; nothing is sent without both.

Args:
    operation_id: id from the catalog (see avito_search_methods).
    path_values: values for {placeholders} in the path.
    query: query-string parameters.
    body: JSON request body.
    confirm_write: must be true.
    i_understand_this_modifies_data: must be true.
Returns JSON: {"ok": true, "status", "data"} or the error envelope.

Input parameters:

- `body`
- `confirm_write` (boolean)
- `i_understand_this_modifies_data` (boolean)
- `operation_id` (string, required)
- `path_values`
- `query`

Output parameters:

- `result` (string)

### `avito_get_raw` (~178 tokens)

Read ANY endpoint by path, including ones missing from the catalog.

Target API: https://developers.avito.ru/api-catalog.

Safe verbs only (GET, HEAD, OPTIONS). To change data use
avito_write_raw, to delete use avito_delete_raw.

Args:
    path: full path beginning with '/', e.g. "/core/v1/items".
    method: safe verb, GET by default.
    host: host override; defaults to the service's default host.
    query: query-string parameters.
    body: JSON request body (rare on reads; some APIs want one).
Returns JSON: {"ok": true, "status", "data"} or the error envelope.

Input parameters:

- `body`
- `host`
- `method` (string)
- `path` (string, required)
- `query`

Output parameters:

- `result` (string)

### `avito_write_raw` (~162 tokens)

Create or update data at ANY path, including paths not in the catalog.

Target API: https://developers.avito.ru/api-catalog.

POST, PUT and PATCH only; requires confirm_write=true.

Args:
    method: POST, PUT or PATCH.
    path: full path beginning with '/'.
    host: host override; defaults to the service's default host.
    query: query-string parameters.
    body: JSON request body.
    confirm_write: must be true.
Returns JSON: {"ok": true, "status", "data"} or the error envelope.

Input parameters:

- `body`
- `confirm_write` (boolean)
- `host`
- `method` (string, required)
- `path` (string, required)
- `query`

Output parameters:

- `result` (string)

### `avito_delete_raw` (~190 tokens)

Delete data at ANY path, including paths not in the catalog.

Target API: https://developers.avito.ru/api-catalog.

DELETE only. Both confirm_write=true and
i_understand_this_modifies_data=true are required.

Args:
    path: full path beginning with '/'.
    method: DELETE.
    host: host override; defaults to the service's default host.
    query: query-string parameters.
    body: JSON request body.
    confirm_write: must be true.
    i_understand_this_modifies_data: must be true.
Returns JSON: {"ok": true, "status", "data"} or the error envelope.

Input parameters:

- `body`
- `confirm_write` (boolean)
- `host`
- `i_understand_this_modifies_data` (boolean)
- `method` (string)
- `path` (string, required)
- `query`

Output parameters:

- `result` (string)

### `avito_fetch_all` (~196 tokens)

Auto-paginate a read endpoint and return every row in one response.

Handles offset, last_id, cursor (Ozon v4/v5), page and WB lastChangeDate
styles. The array path is taken from the catalog automatically.

Args:
    operation_id: a read endpoint from the catalog.
    query / body / path_values: base parameters (cursor fields are managed).
    items_path: override the array path (default: the endpoint's own).
    limit: page size to request.
    max_items: hard cap to protect context (default 10000).
Returns JSON: {"ok", "items", "total_fetched", "pages_fetched", "truncated"}.

Input parameters:

- `body`
- `items_path`
- `limit` (integer)
- `max_items` (integer)
- `operation_id` (string, required)
- `path_values`
- `query`

Output parameters:

- `result` (string)

### `avito_list_cabinets` (~54 tokens)

List configured cabinets for this marketplace and which one is active.

Returns JSON: {"active": str|null, "cabinets": [names], "fields_needed": [...]}.
Secret values are never returned.

Output parameters:

- `result` (string)

### `avito_add_cabinet` (~219 tokens)

Add or update a cabinet (a named set of API credentials), from chat.

⚠️ This puts the key into the chat transcript — requires
i_understand_key_goes_to_chat=true. The terminal-free safe alternative is
the installer (install.py / double-click), where the key never enters chat.

Args:
    credentials: dict with the required fields for this service
        ({fields}). For Ozon: {{"client_id": "...", "api_key": "..."}};
        for WB: {{"token": "..."}}.
    name: optional label. If omitted, the cabinet is named after the real
        shop name fetched from the marketplace (falls back to "main").
    i_understand_key_goes_to_chat: must be true to proceed.
Saved to ~/.marketplace-mcp/cabinets.json (local, chmod 600), never echoed.

Input parameters:

- `credentials` (object, required)
- `i_understand_key_goes_to_chat` (boolean)
- `name` (string)

Output parameters:

- `result` (string)

### `avito_set_key` (~222 tokens)

Change / rotate the API key from chat (e.g. the old one expired or
leaked).

⚠️ The key goes into the chat transcript — requires
i_understand_key_goes_to_chat=true. The safe, terminal-free alternative
is the installer, where the key never enters chat. Use a scoped key and
rotate it in the seller cabinet if it was exposed.

Args:
    credentials: dict with the required fields ({fields}).
    cabinet: which cabinet to update. Default: the active one (so "my key
        expired" just works). If there is none, the cabinet is named from
        the marketplace's shop name, else "main".
    i_understand_key_goes_to_chat: must be true to proceed.
On success the key is validated against the marketplace and the shop name
is reported. Saved locally (chmod 600), never echoed back.

Input parameters:

- `cabinet` (string)
- `credentials` (object, required)
- `i_understand_key_goes_to_chat` (boolean)

Output parameters:

- `result` (string)

### `avito_use_cabinet` (~50 tokens)

Switch the active cabinet. Subsequent API calls use its credentials.

Args:
    name: the cabinet to activate (see avito_list_cabinets).

Input parameters:

- `name` (string, required)

Output parameters:

- `result` (string)

### `avito_remove_cabinet` (~43 tokens)

Delete a stored cabinet. If it was active, another becomes active.

Args:
    name: the cabinet to remove.

Input parameters:

- `name` (string, required)

Output parameters:

- `result` (string)

### `avito_list_workflows` (~55 tokens)

List ready-made analytical workflows (recipes) for this marketplace.

Returns JSON: [{name, category, when_to_use}]. Use {svc}_get_workflow
to fetch the full step-by-step plan for one.

Output parameters:

- `result` (string)

### `avito_get_workflow` (~66 tokens)

Return the full plan for one workflow: ordered steps (each naming a
catalog operation_id and why), interpretation guidance, and common
mistakes to avoid.

Args:
    name: workflow name (see {svc}_list_workflows).

Input parameters:

- `name` (string, required)

Output parameters:

- `result` (string)

### `avito_whoami` (~66 tokens)

Authorized Avito account: id (needed as user_id in many methods), name,
email, phone, profile_url. Also the cheapest way to verify the credentials.
Returns JSON: {"ok": true, "data": {"id": ..., "name": ..., ...}}.

Output parameters:

- `result` (string)

### `avito_get_items` (~179 tokens)

List the seller's listings (объявления): status, category, url
(GET /core/v1/items). Max 25 requests/min.

Args:
    status: active | removed | old | blocked | rejected (comma-separated ok).
    category: Avito category id filter, 0 = all.
    updated_from: YYYY-MM-DD lower bound on the listing update date.
    page: 1-based page number.
    per_page: page size (<100).
Returns JSON: {"ok": true, "data": {"meta": {...}, "resources": [...]}}.
For all pages use avito_fetch_all with avito_get_items_info.

Input parameters:

- `category` (integer)
- `page` (integer)
- `per_page` (integer)
- `status` (string)
- `updated_from` (string)

Output parameters:

- `result` (string)

### `avito_get_orders` (~182 tokens)

Orders placed with Авито Доставка (GET /order-management/1/orders).
Business (B2C) sellers only.

Args:
    statuses: comma-separated filter: on_confirmation, ready_to_ship,
        in_transit, canceled, delivered, on_return, in_dispute, closed.
    date_from: unix timestamp — only orders created after it.
    page: 1-based page number.
    limit: page size (<=20).
Returns JSON: {"ok": true, "data": {"orders": [...], "hasMore": bool}}.
Each order has availableActions (confirm / reject / setTrackNumber …) and
schedules (deadlines such as confirmTill, shipTill).

Input parameters:

- `date_from` (integer)
- `limit` (integer)
- `page` (integer)
- `statuses` (string)

Output parameters:

- `result` (string)

### `avito_get_stocks` (~88 tokens)

Stock per listing (POST /stock-management/1/info): quantity,
is_unlimited, is_out_of_stock. Up to 500 ids per call.

Args:
    item_ids: comma-separated Avito listing ids.
Returns JSON: {"ok": true, "data": {"stocks": [{"item_id", "quantity", ...}]}}.

Input parameters:

- `item_ids` (string, required)

Output parameters:

- `result` (string)

### `avito_get_item_stats` (~141 tokens)

Views / contacts / favorites per listing per period
(POST /stats/v1/accounts/{user_id}/items). Up to 200 ids, 270 days deep.

Args:
    item_ids: comma-separated listing ids.
    date_from: YYYY-MM-DD (inclusive).
    date_to: YYYY-MM-DD (inclusive).
    period_grouping: day | week | month.
Returns JSON with result.items[].stats[] {date, uniqViews, uniqContacts, uniqFavorites}.

Input parameters:

- `date_from` (string, required)
- `date_to` (string, required)
- `item_ids` (string, required)
- `period_grouping` (string)

Output parameters:

- `result` (string)

### `avito_get_reviews` (~110 tokens)

Published reviews on the seller with score, text, deal stage and the
seller's answer (GET /ratings/v1/reviews). Use avito_get_ratings_info_v1
via avito_call_method for the aggregate rating.

Args:
    offset: pagination offset.
    limit: page size (<=50).
Returns JSON: {"ok": true, "data": {"total": n, "reviews": [...]}}.

Input parameters:

- `limit` (integer)
- `offset` (integer)

Output parameters:

- `result` (string)

### `avito_get_chats` (~149 tokens)

Buyer chats (GET /messenger/v2/accounts/{user_id}/chats). Requires the
Messenger API to be enabled on the seller's Avito plan.

Args:
    unread_only: only chats with unread messages.
    item_ids: comma-separated listing ids to filter chats by.
    limit: page size (<=100).
    offset: pagination offset (<=1000).
Returns JSON: {"ok": true, "data": {"chats": [{"id", "context", "last_message", "users"}]}}.

Input parameters:

- `item_ids` (string)
- `limit` (integer)
- `offset` (integer)
- `unread_only` (boolean)

Output parameters:

- `result` (string)

### `avito_get_balance` (~52 tokens)

Wallet balance: real money and bonuses (GET /core/v1/accounts/{user_id}/balance/).
Returns JSON: {"ok": true, "data": {"real": ..., "bonus": ...}}.

Output parameters:

- `result` (string)

### `avito_update_price` (~130 tokens)

Set the price of ONE listing (POST /core/v1/items/{item_id}/update_price). WRITE.

Requires confirm_write=true. Goods, spare parts, cars, real estate only;
max 150 requests/min.

Args:
    item_id: Avito listing id.
    price: new price in roubles (integer).
    confirm_write: must be true to send.
Returns JSON: {"ok": true, "data": {"result": {"success": true}}}.

Input parameters:

- `confirm_write` (boolean)
- `item_id` (integer, required)
- `price` (integer, required)

Output parameters:

- `result` (string)

### `avito_update_stock` (~128 tokens)

Set the available quantity of ONE listing (PUT /stock-management/1/stocks). WRITE.

Requires confirm_write=true. quantity 0 hides the "buy with delivery" button.

Args:
    item_id: Avito listing id.
    quantity: units available (0..999999).
    confirm_write: must be true to send.
Returns JSON: {"ok": true, "data": {"stocks": [{"item_id", "success", "errors"}]}}.

Input parameters:

- `confirm_write` (boolean)
- `item_id` (integer, required)
- `quantity` (integer, required)

Output parameters:

- `result` (string)

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Dependencies. The full working is on the page: https://verifymcp.io/servers/ilyautov-avito-mcp-ru/avito-mcp-ru#diagnostics

## Score history

- 2026-09-20: 67
- 2026-09-19: 67
- 2026-09-18: 67
- 2026-09-17: 66
- 2026-09-16: 66
- 2026-09-15: 65
- 2026-09-14: 65
- 2026-09-13: 51

## Common questions

### What is the Авито MCP (RU) server?

Авито MCP (RU) is listed in the public MCP registry as io.github.ilyautov/avito-mcp-ru. API Авито в ИИ-ассистенте: объявления, чаты, заказы, автозагрузка, отзывы. This page covers its PyPI package (avito-mcp-ru).

### Is the Авито MCP (RU) server safe to use?

Авито MCP (RU) scores 67 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Авито MCP (RU) server expose?

Авито MCP (RU) exposes 30 tools: avito_check_auth, avito_list_sections, avito_get_section, avito_search_methods, avito_map, and 25 more. Their descriptions and schemas cost roughly 3,528 tokens of context every time the server is loaded.

### Is the Авито MCP (RU) server still maintained?

Авито MCP (RU) is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- PyPI project: https://pypi.org/project/avito-mcp-ru/
- Socket report: https://socket.dev/pypi/package/avito-mcp-ru
- Repository: https://github.com/ilyautov/avito-mcp-ru
- Website: https://marketplaces-mcp-ru.aifrontier.tech/avito-api.html
- Changelog RSS feed: https://verifymcp.io/servers/ilyautov-avito-mcp-ru/avito-mcp-ru.xml
- Changelog JSON feed: https://verifymcp.io/servers/ilyautov-avito-mcp-ru/avito-mcp-ru.json
- HTML version of this page: https://verifymcp.io/servers/ilyautov-avito-mcp-ru/avito-mcp-ru