io.github.elchin92/avito-mcp

reader

writer

spender

sender

Read probe

echo

A read-only tool

A write tool

Spends money

Visible to customers

No risk specified — defaults to write

profile

test-only probe

Returns detailed information about current and available target-action bids for ONE listing: the active price/budget, the minimum/maximum/recommended values (all in kopecks), the selected strategy (manual/auto), and a target-action forecast with the advantage over competitors. Read-only — does not change spending. Use it before save_manual_bid/save_auto_bid to find the allowed min/max/recommended amounts. For multiple listings at once, use cpa_target_get_promotions_by_item_ids (batch up to 200). Limit: 20 requests/min.

Returns current target-action bids and budgets (in kopecks) for MULTIPLE listings at once (batch, up to 200 per request): for each listing — actionTypeID and the active manual or auto strategy with its price/limit/budget. Read-only — does not change spending. Use it to bulk-check current settings; for a single listing with full min/max/recommendations and a forecast, use cpa_target_get_bids. Limit: 400 requests/min.

⚠️ STOPS target-action promotion for a listing and switches it to the base price from the price list. WARNING: removes the active manual or auto bid — the settings are reset, and to resume promotion you will have to set them again (save_manual_bid/save_auto_bid). Does not reduce spending to zero: the listing keeps being charged at the base target-action price. Returns a text message about the switch. Limit: 300 requests/min.

⚠️ Enables the AUTOMATIC target-action bidding strategy: the system picks the price itself within the specified budget. WARNING: affects budget spending (money) — sets a spend of budgetPenny per budgetType period. Mutually exclusive with the manual bid: this call overwrites any previously set manual strategy for this listing. Use it when you want to delegate price management to Avito (rather than fixing the amount manually — use save_manual_bid for that). budgetPenny must fall within min/maxBudgetPenny from cpa_target_get_bids. Not available in the "Transport" category. Limit: 10 requests/min.

⚠️ Sets a MANUAL (fixed) target-action bid for a listing (manual bid). WARNING: affects budget spending (money) — each target action is charged at bidPenny, and daily spending is capped by limitPenny. Mutually exclusive with the auto bid: this call overwrites any previously set auto strategy for this listing. Use it when you want to control the per-action price yourself (to delegate the choice to Avito, use save_auto_bid). bidPenny must be no lower than minBidPenny from cpa_target_get_bids. Limit: 20 requests/min.

Returns Avito messenger webhook events RECEIVED by this server (new chat messages), newest-first.

Returns the configuration and live stats of this server's Avito webhook RECEIVER: whether it is enabled,

Subscribes Avito to THIS server's configured webhook receiver URL so messenger events (new chat messages) start flowing.

Checks the status of the current user within the account hierarchy (check_ah_user).

Returns the list of account-hierarchy employees of the managing company (get_employees).

Returns the list of phone numbers of the managing company in the account hierarchy (list_company_phones) with cursor-based pagination.

Assigns listings to an employee within the account hierarchy (link_items). Changes the ownership of listings inside the managing account: a repeated call reassigns them to a different employee.

Returns the IDs of listings assigned to a specific hierarchy employee, filtered by category (list_items_by_employee).

Returns the recording (audio) of a CPA call by its identifier (v1, deprecated). Read-only, spends no money. Deprecated — prefer cpa_get_call_by_id_v2 (or calltracking get_record_by_call_id), which return the full call model together with the recording. Limit: 1 request/min.

Returns the CPA chat model by target-action identifier (actionId). Read-only, spends no money. Use when you already have the actionId of a specific chat (from cpa_chats_by_time_v2); not for iterating by time. Limit: 3 requests/min.

Returns a paginated list of target CPA chats created starting from the given moment (v1, deprecated). Read-only, spends no money. Deprecated — prefer cpa_chats_by_time_v2 (identical semantics, higher request limit: 40 vs 60/min for v1, but v2 is the current version).

⚠️ Files an external complaint with Avito about a CPA call by its callId (action record) — e.g. when disputing a charge for an off-target call. Irreversible record: a complaint cannot be withdrawn, so confirmation is required by default. Requires the callId of a specific call from a preceding call (cpa_get_calls_by_time_v2). To file complaints about both calls and chats by a single actionId, use cpa_create_complaint_by_action_id. Limit: 1 request/min.

⚠️ Files an external complaint with Avito about a CPA target action (call or chat) by its actionId — to dispute a charge for an off-target action. Irreversible record: a complaint cannot be withdrawn, so confirmation is required by default. Requires the actionId from a preceding call (cpa_chats_by_time_v2 / cpa_get_calls_by_time_v2). Preferred over cpa_post_create_complaint, since it covers both calls and chats. Limit: 3 requests/min.

Returns a paginated set of information on phone numbers extracted from target CPA chats starting from the given moment. Read-only, spends no money. Use to export customer contacts from correspondence over a period. Limit: 5 requests/min.

Returns the CPA wallet balance in kopecks: balance, debt, and the current month\'s advance (v2, deprecated). Read-only, spends no money. The request body is empty (`{}`). Deprecated — prefer cpa_balance_info_v3 (the current version). Limit: 1 request/min.

Returns the full CPA call model by callId, including a link to the recording (v2). Read-only, spends no money. Use when the callId is already known (from cpa_get_calls_by_time_v2). The current replacement for the deprecated cpa_get_call (v1).

Returns a paginated list of CPA calls created starting from the given moment (by startTime) (v2). Read-only, spends no money. Use to iterate over calls for a period; the returned callId/actionId values are then suitable for cpa_get_call_by_id_v2 or filing a complaint. Limit: 1 request/min.

Returns a paginated list of target CPA chats created starting from the given moment (by the date field) (v2 — current). Read-only, spends no money. Prefer this method over the deprecated cpa_chats_by_time_v1. The returned actionId values are then suitable for cpa_chat_by_action_id or filing a complaint. Limit: 40 requests/min.

Returns the current balance of the user\'s CPA wallet in kopecks (v3 — current). Read-only, spends no money. The request body is empty (`{}`). v3 differs from v2 in having an updated response structure — prefer v3. Limit: 1 request/min.

Returns the autoload profile settings (v1): autoload_enabled, report_email, the schedule, and the deprecated upload_url field.

Creates or updates (upsert) a v1 autoload profile with a single URL feed. Overwrites the existing profile settings on the Avito side;

⚠️ Immediately LAUNCHES an unscheduled upload of listings from the feed at the URL specified in the profile settings (autoload_create_or_update_profile_v2).

Returns the full Avito category tree (an array of nodes with name, slug/id and nested children) for preparing an autoload feed.

Returns the fields (tags) of a specific category for filling out the feed: their types (input/select/checkbox), whether they are required, dependencies between fields, allowed values, and references to catalogs.

Returns the listing identifiers from the autoload file (ad_id) by their Avito identifiers (avito_id) — an avito_id → ad_id mapping.

Returns the Avito listing identifiers (avito_id) by their identifiers from the autoload file (ad_id) — an ad_id → avito_id mapping.

Returns the autoload profile settings (v2, current version): autoload_enabled, report_email, the schedule, and the feeds_data array of feeds (name + file link).

Creates or updates (upsert) an autoload profile (v2, current version). Overwrites the existing profile settings on the Avito side; if no profile exists, it creates one.

Returns a list of autoload reports (id, started_at, finished_at, status) with pagination and a filter by creation date.

Returns the current state of listings in autoload by their IDs from the file: avito_id, avito_status, report section, errors/warnings (messages), charge information, and processing date.

Returns summary statistics of the last completed upload (v2 format): per-section counters (section_stats), charges (listing_fees), events, and the feed_url link.

Returns summary statistics of a specific upload by its report_id (v2 format): section_stats, listing_fees, events, status, and the feed_url link.

Returns the processing result of each listing in a specific upload (by report_id): ad_id, avito_id, avito_status, report section, errors/warnings, and a link.

Returns the placement charges for each listing in a specific upload (by report_id): ad_id, avito_id, charge type (single — from the wallet / package — from a package), and the amount or package ID.

Returns summary statistics of the last completed upload (v3, current format): per-section counters (section_stats), charges (listing_fees), events, and the feeds_urls array of links.

Returns summary statistics of a specific upload by its report_id (v3, current format): section_stats, listing_fees, events, status, and the feeds_urls array of links.

Returns a LIST of the authenticated user\'s listings (get_items_info) — id, status, category, link on the site.

Returns detailed information about a SINGLE listing (get_item_info) — status, price, address, list of applied VAS services, etc.

Returns aggregated CALL statistics for listings over a period (post_calls_stats) — total/new/answered/new answered, broken down by day.

Returns the cost of promotion services (VAS), available packages and stickers for the given listings (post_vas_prices).

Returns counters (shallow statistics) for a list of listings over a period (post_item_stats_shallow / itemStatsShallow): unique views, contacts, favorites added.

Returns EXTENDED statistical metrics for the profile/listings over a period (post_item_analytics, stats v2): views, contacts, presenceSpending, etc. with flexible grouping, filters and sorting.

Returns a REPORT of the profile\'s spendings over a period by Avito spending category: all, promotion, presence, commission, or rest.

Changes a listing\'s price (update_price). ⚠️ PUBLIC: the new price is immediately visible to buyers on the site. Requires item_id and price (integer, in rubles).

Applies ONE additional promotion service (VAS) to a listing (put_item_vas). ⚠️ MONEY: charges money from the balance; irreversible. The response contains service data and the charged amount.

Applies a PACKAGE of promotion services (VAS) to a listing (put_item_vas_package_v2). ⚠️ MONEY: charges money from the balance; irreversible. The response contains the charged amount.

Applies ONE OR MORE promotion services (slugs) and/or stickers to a published listing (apply_vas, v2 — the current method). ⚠️ MONEY: charges money; irreversible. The response contains the IDs of the purchase operations for status tracking.

Returns a list of delivery orders (get_orders) with filters by ID, status, and creation date.

Returns the available time slots for a courier to pick up the item (get_courier_delivery_range), for seller-courier delivery (RDBS/Courier).

Downloads the generated PDF file with labels by taskID (download_label). Read-only, changes nothing.

⚠️ Submits "Chestny Znak" marking codes (DataMatrix) for the items in an order (markings).

⚠️ Confirms the buyer\'s return of an item and selects the Russian Post office the return parcel will be sent to (accept_return_order).

⚠️ Applies an order status transition (apply_transition), such as confirmation or cancellation.

Verifies the confirmation code for handing over an order at a pickup point (check_confirmation_code): the buyer states the code from the app and the method validates it.

⚠️ Prepares a click-and-collect order and sends the details to the buyer (cnc_set_details, CNC = click-and-collect).

⚠️ Selects (books) a specific time slot for a courier to pick up the item (set_courier_delivery_range), for seller-courier delivery.

⚠️ Submits the parcel tracking number for delivery by the seller\'s partners (set_tracking_number, DBS).

Creates a task to generate PDF labels for orders (generate_labels, up to 100 orders at a time).

Creates a task to generate PDF labels for a large batch of orders (generate_labels_extended, up to 1000 orders at a time).

OAuth 2.0 client_credentials: obtain an application access_token.

OAuth 2.0 authorization_code: exchange an authorization code (obtained after the redirect

OAuth 2.0 refresh_token: refresh an expired user access_token via refresh_token.

Reads current stock (available quantity) for a list of listings in the warehouse (get_stocks_info). Read-only, changes nothing. Returns for each item_id: quantity (available = submitted/edited minus reserved), is_unlimited, is_multiple, is_out_of_stock. To change stock, use stock_update_stocks.

⚠️ Updates the stock (quantity) of items across listings in the warehouse (update_stocks). Affects whether listings are available to order: quantity=0 marks a listing as "out of stock". Accepts an array of {item_id, quantity, external_id?}; quantity is an integer 0..999999. Returns success and errors for each listing. For current stock, use stock_get_stocks_info.

Reads active and available CPA auction bids for the user\'s listings (read-only, does not change spending).

Saves (overwrites) CPA auction bids for listings. WARNING: affects auction spending (money) — a higher bid means a higher display position.

Returns metadata for a single call-tracking call by its callId (read-only): call time, talk and wait durations, buyer/seller phone numbers, the protective (virtual) number, and the listing itemId.

Returns a list of call-tracking calls over a time range, filtered by call time (callTime), with pagination (read-only). Requires a time window in RFC3339 format.

Downloads the call-tracking conversation audio recording for a specific callId (read-only). Returns a structured binary response {mimeType: "audio/mpeg" (or wav), sizeBytes, base64}; decode the base64 to save the file (it may be several MB).

Returns the forecast effect of BBIP promotion (listing promotion bid/budget): expected increase in

Returns recommended BBIP promotion bid/budget options for the listings. READ-ONLY: spends NO money.

⚠️ PAID ACTION (money): creates a BBIP order to enable promotion for listings and CHARGES the budget

Returns a dictionary of all Avito promotion service types: for each service — slug (type identifier),

Returns active promotion services for the specified listings: for each listing, a list of services with

Returns a paginated list of the current user's promotion orders: id (UUID), createdAt and

Returns the status of a BBIP order by its orderId: the order's overall status (initialized/waiting/in_process/processed),

Returns a LIST of the account's chats (conversations with buyers) with a preview of the last message and an unread counter.

Returns the details of a SINGLE chat by a known chat_id: participants, linked item, context, and the last message.

Returns the MESSAGES of a specific chat (V3), sorted newest to oldest: text, images, voice, links, date, and author.

Returns temporary download URLs for voice messages by their voice_id. Read-only.

Returns a LIST of the account's active webhook subscriptions: notification URLs and their versions/status.

Sends a TEXT message to a chat on behalf of the account. WARNING: the message is immediately and PUBLICLY visible to the other party (the buyer)

Sends an IMAGE (by an already-uploaded image_id) to a chat on behalf of the account. WARNING: the image is immediately and PUBLICLY visible to the other party.

Deletes a SINGLE message from a chat by message_id. WARNING: IRREVERSIBLE — the message cannot be restored;

Marks the unread messages of the specified chat as read, recording a read receipt and clearing the unread counter.

Adds one or more users to the account's BLACKLIST. WARNING: a blocked user will no longer be able to message you in the messenger;

SUBSCRIBES THIS server's operator-configured receiver URL to webhook notifications (V3) about new messenger events.

UNSUBSCRIBES the specified URL from messenger webhook notifications — Avito will stop sending events to this address.

UPLOADS images from the local disk to the Avito messenger (multipart) and returns an image_id.

Returns the account tariff information for the Transport category (tariffs_get_tariff_info, read-only).

Returns the most recently observed X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset values,

Universal health-check: package version, active capabilities, rate-limit

Reports only token METADATA: present/absent, expiresInSec, last refresh

Returns a machine-readable description of the current configuration: mode, allow/deny lists,

⚠️ Executes a previously deferred action by its confirmation_id.

Cancels a previously deferred action. After cancellation the confirmation_id is no longer valid.

Lists the current pending actions awaiting confirmation. Args are not shown —

[BETA] Checks whether a discount/special-offer messenger campaign is available for a list of listings (available).

[BETA] Creates a draft discount/special-offer messenger campaign for a list of listings and locks in the recipient audience (multi_create).

[BETA] ⚠️ SECOND, final step: confirms and PAYS from the Avito wallet for the discount/special-offer campaign created via msg_discounts_open_api_multi_create (multi_confirm).

[BETA] Returns statistics for already-sent discount/special-offer campaigns over a period (stats).

[BETA] Returns information about the current discount/special-offer campaign plan: how many campaigns remain (sendsLeft) and the total allowance (totalSends) (tariff_info).

[3PL] Creates an announcement of a planned shipment from one delivery service (sender) to another (receiver).

[3PL] Cancels a previously created shipment announcement in the delivery service. Irreversibly cancels an announcement created via

[3PL] Production creation of a parcel on the delivery-service side (CreateParcelRequest). The method is implemented

[SANDBOX] Creates an announcement of a planned shipment to Avito in the test environment; after creation the announcement

[SANDBOX] Appends one tracking event for an announcement from the delivery service; does not modify existing history —

[SANDBOX] Sets the working schedule of a delivery zone for a specific day that differs from the regular schedule

[SANDBOX] Cancels a test parcel on behalf of the receiver (actor=receiver); returns a success status. Only parcels created via

[SANDBOX] Verifies the confirmation code that the buyer shows at the pickup point upon handover. Returns

[SANDBOX] Sets a parcel's delivery parameters on Avito — e.g. the final delivery cost.

[SANDBOX] Sends Avito the ACTUAL pickup point used for a parcel's acceptance/return — needed for agent and customer returns.

[SANDBOX] Appends one parcel tracking event to Avito on behalf of the delivery service; does not modify existing history —

[SANDBOX] Prohibits the delivery service from accepting a parcel from the sender — the parcel will not be taken into processing.

[SANDBOX] Returns the sorting centers (hubs) for the specified delivery services. For delivery-service partners only.

[SANDBOX] Creates a task to upload your own sorting centers (hubs) with initial validation;

[SANDBOX] Uploads the areas where courier delivery/pickup is available for the specified tariff.

[SANDBOX] Creates a task to assign direction tags to your own and/or third-party sorting centers within

Replaces the tariff's terminal set. [SANDBOX] Uploads terminals (pickup points / parcel lockers) for one tariff.

[SANDBOX] Creates a task to update the delivery-term zones in a tariff; returns a taskID — status via

Creates or replaces a tariff. [SANDBOX v2] Uploads a tariff so the delivery service controls direction availability,

[SANDBOX] Returns the status of an asynchronous task by the taskID obtained from upload operations

[SANDBOX v1] Starts the process of cancelling a test announcement; on success the response has a success status. Available

[SANDBOX v1] Cancels a test parcel: initiates an acceptance prohibition at the delivery service and, if it took effect, cancels the parcel.

[SANDBOX v1] Creates a request to change ONE test parcel's data (e.g. the receiver's name/phone), per the type enum

[SANDBOX v1] Creates a test shipment announcement in the Sandbox (no real-world effect); returns a success status.

[SANDBOX v1] Returns the last registered event for a test announcement — makes it easier to debug

[SANDBOX v1] Returns information about a test-parcel change request by its applicationID (the request

[SANDBOX v1] Returns information about a test parcel by parcelID. Available only in the Sandbox; works

[SANDBOX v1] Returns the parcelID of a registered test parcel by its orderID. Works only with

[SANDBOX v2] Creates a test parcel in the Sandbox (no real-world effect) and returns its parcelID — the entry point for the

[3PL] Sends Avito the outcome of a parcel change request previously sent via

[SANDBOX] Queues a BATCH of parcel-property change requests on Avito's initiative (changeReceiver / extendParcelStorage /

Checks transactional promo availability and the allowed commission range for listings (trxpromo_get_commissions, read-only — does not start anything or charge any fee).

⚠️ Applies transactional promo/promotion with a pay-per-result commission to listings (trxpromo_apply). Affects price/spend: the promotion fee is added on top of the base commission.

⚠️ Cancels active and scheduled transactional promo for listings (trxpromo_cancel). Reverts the effect of trxpromo_apply — the promotion and its associated commission stop applying.

Returns the aggregated rating of the current user (reviews_get_ratings_info_v1): average score, the total number of active reviews and the number of reviews that affect the rating, plus a flag indicating whether the rating is enabled. Takes no parameters and returns no paginated data. To get the list of reviews itself, use reviews_get_reviews_v1.

Returns a paginated list of active reviews for the current user (reviews_get_reviews_v1): review id, score, text, author, listing, attached photos and the current seller answer, plus total — the overall number of reviews. Use it to browse individual reviews and obtain the reviewId (required for reviews_create_review_answer_v1). If you only need the aggregate score without the list, use reviews_get_ratings_info_v1.

Publishes a seller answer to a review (reviews_create_review_answer_v1). WARNING: the answer is PUBLIC — once moderated it is visible to everyone on the profile page. Requires reviewId (from reviews_get_reviews_v1) and the message text; returns the id of the created answer and a timestamp. Confirm the action with the user. To delete an answer, use reviews_remove_review_answer_v1.

Permanently deletes a previously published seller answer to a review (reviews_remove_review_answer_v1). WARNING: deletion is IRREVERSIBLE and immediately removes the public answer from the profile; returns a success flag. Confirm the action with the user. To publish an answer again, use reviews_create_review_answer_v1.

Reads the account wallet balance (get_user_balance): the amount of real money (real) and the amount of bonus funds (bonus) in rubles. Read-only, a point-in-time snapshot. This is the Personal Account wallet, not the CPA balance (for CPA see the cpa domain). For the history of charges/top-ups use post_operations_history.

Returns the list of account wallet operations for a period (post_operations_history): charges and top-ups in money and bonuses, with amountRub, amountBonus, amountTotal, operation type/name, service type (vas, cpa, tariff, etc.), itemId, and dates for each operation. Read-only. These are Personal Account wallet movements, not the CPA balance. Constraints: dateTimeFrom no more than a year ago, the range between from/to no more than one week; for the current balance use get_user_balance.