Avito MCP

Name: Avito MCP
Author: elchin92

作者：elchin92バージョン 2.1.1i★ –iパソコンで動く

レジストリ名io.github.elchin92/avito-mcp

インストール

概要

作者による説明（英語の原文）

MCP server for Avito: chats, listings, orders and analytics, with previews and confirmations.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況iとても新しい↓ 159/週 · ★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: ネットショップ・決済
入力が必要なもの：Client_id, Client_secret, Profile_id

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： Client_id, Client_secret, Profile_id, AVITO_MCP_PROTOCOL_ERA

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

npmNode.jsのインストール（npxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "avito": {
      "command": "npx",
      "args": [
        "-y",
        "avito-mcp"
      ],
      "env": {
        "Client_id": "your-value",
        "Client_secret": "your-value",
        "Profile_id": "your-value",
        "AVITO_MCP_PROTOCOL_ERA": "your-value"
      }
    }
  }
}

ターミナルでこれを実行します

claude mcp add avito --env Client_id=your-value --env Client_secret=your-value --env Profile_id=your-value --env AVITO_MCP_PROTOCOL_ERA=your-value -- npx -y avito-mcp

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "avito": {
      "command": "npx",
      "args": [
        "-y",
        "avito-mcp"
      ],
      "env": {
        "Client_id": "your-value",
        "Client_secret": "your-value",
        "Profile_id": "your-value",
        "AVITO_MCP_PROTOCOL_ERA": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "avito": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "avito-mcp"
      ],
      "env": {
        "Client_id": "your-value",
        "Client_secret": "your-value",
        "Profile_id": "your-value",
        "AVITO_MCP_PROTOCOL_ERA": "your-value"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

Client_id 秘密必須 env
Avito OAuth client_id (from https://www.avito.ru/professionals/api).
Client_secret 秘密必須 env
Avito OAuth client_secret (from https://www.avito.ru/professionals/api).
Profile_id 必須 env
Avito profile id (numeric account id); auto-injected into {user_id}/{userId} path params.
AVITO_MCP_PROTOCOL_ERA env
Which MCP protocol revisions this process serves: legacy = 2025-11-25 only, dual = 2025-11-25 and 2026-07-28, modern = 2026-07-28 only.

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月10日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント elchin92 で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

ネットショップ・決済のほかのサーバーとの比較i

このカテゴリのほかの2635件のうち0%よりスターが多い
このカテゴリのほかの2635件のうち32%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの2635件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Avito MCPは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：Client_id, Client_secret, Profile_id

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（2.1.1）がレジストリに届いたのは2 か月前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは？

同じカテゴリには：Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：↓ 週あたりのダウンロードi★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Spree Commerce: open-source B2B and marketplace ecommerce

Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.

作者：spree広く使われている★ 1.6万10 日前更新

クラウドで動く

インストール

Stripe MCP

MCP server integrating with Stripe - tools for customers, products, payments, and more.

作者：stripe広く使われている★ 204313 か月前更新

クラウドで動く✓ stripe.com

インストール

MCP Cn Commerce

8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending

作者：TonyWang-hub初期↓ 73/週★ 9630 日前更新

パソコンで動く

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

avito-mcp

Connect your AI client to your Avito account: read chats and statistics, prepare replies, and manage listings and orders.

Ask your AI client in plain language; it uses this MCP server to call the official Avito APIs. 148 tools across 18 APIs cover buyer chats, listings, statistics, promotion and orders. Run it on your computer or your own server.

You bring an AI client and an Avito account with API access. The client provides the model; this project provides the connection and tools. Automatic replies and scheduled reports need an agent or scheduler configured separately.

[Русская версия →](README.ru.md) · Documentation · Client setup · Workflows · Troubleshooting

New in v2.1.1: step-by-step setup, complete English and Russian workflow and troubleshooting guides, and explicit demo versus live-account instructions. Release notes.

Your next step	Guide
See it work without an Avito account	Run the demo
Connect your own account	Quick start
Set up a client you already use	Client configurations
Deploy or contribute	Operations · Contributing

Try without Avito credentials

npx -y avito-mcp@2 --demo

The demo uses fictional data: 53 listings and 2 unread chats. It runs locally, needs no Avito keys and sends no requests to Avito. It walks through a report, a price preview, confirmation and a repeated request that changes the price only once. The first npx run downloads the npm package; from source, use npm run demo.

To use your own Avito account, follow the quick start and omit `--demo`. Normal server calls use your configured account; demo data never replaces it.

What you can do

Task	Start here	Result
Check how your listings are doing	Morning report, analytics profile	Balance, listing activity and spending, with dates and source IDs
Work through buyer messages	Unread-chat triage, messenger profile	Prioritised chats and draft replies; sending is a separate confirmed action
Change a listing price	Preview and confirm, seller profile	Request preview, pending action, then a result to check

Profiles use existing environment variables to expose a focused tool set. The recipes explain what to ask, which tools are involved, and how to check the result.

Quick start

1. Prepare your account

You need Node.js 22.12+, an MCP-capable AI client, and Avito API credentials for your account. Obtain Client_id, Client_secret, and numeric Profile_id through Avito's API account page. Available methods depend on your account's API access; installing this server does not grant additional Avito permissions.

2. Add the server to your client

For Claude Desktop, merge this into its MCP config using Settings → Developer → Edit Config. For Cursor, use your personal ~/.cursor/mcp.json. Replace the three placeholders locally and keep the filled config out of Git.

"mcpServers": { "avito": { "command": "npx", "args": ["-y", "avito-mcp@2"], "env": { "Client_id": "YOUR_CLIENT_ID", "Client_secret": "YOUR_CLIENT_SECRET", "Profile_id": "YOUR_PROFILE_ID", "AVITO_MCP_MODE": "read_only" } } } }

3. Check a real read

Restart the client and ask: “Use Avito to show my account balance and the first page of active listings. Do not change anything.” A successful answer should show your real balance and listing IDs, or an empty list if the account has no listings. The example starts in read_only; without this setting the server's default remains full_access.

VS Code, Zed, Codex and ChatGPT use their own setup formats. Copy the client-specific config, then try a workflow. The examples pin major version 2; pin an exact published version for controlled deployments.

Connect your AI client

Client	Ready-to-copy config
Claude Desktop	JSON + setup
Cursor	JSON + setup
VS Code / Copilot	`servers` JSON
Zed	`context_servers` JSON
Codex CLI / IDE extension	TOML
ChatGPT desktop	Settings → MCP servers or shared TOML
ChatGPT web	Remote plugin setup and limits

These are documented configurations, not a claim that every client/version has been tested against a live Avito account. Report compatibility results with the client version and operating system.

API coverage

Domain	Examples
Messenger	Chats, messages, images, subscriptions and webhook events
Listings and statistics	Listing details, prices, views, contacts and spending
Orders and stock	Delivery statuses, tracking, labels, marking codes and stock
Promotion	VAS, CPA bids, forecasts and promotion orders
Autoload	Feed uploads, reports and ID mapping
Account and other APIs	Balance, reviews, staff, tariffs and calls
Logistics partners	3PL delivery endpoints; most sellers do not need these

The bundled API snapshot covers 138 Swagger operations plus local and meta tools. The full manifest has 148 tools; default registration exposes 144, because token-returning tools and local image uploads require separate opt-ins. read_only exposes 80 before allowlist filtering. Inspect avito://manifest or build dist/manifest.json for exact names, schemas and risks.

Resources include the tool manifest, active configuration, rate limits, pending confirmations and webhook events. Five built-in prompts cover a daily overview, unread chats, promotion preparation, tool explanations and a safety report. Resource and prompt reference.

Safety and retries

read_only, guarded, and full_access, plus AVITO_MCP_ALLOW_TOOLS / AVITO_MCP_DENY_TOOLS, control which tools are available.
dryRun: true previews a destructive request without sending it. It does not reserve an action or validate the live account's permission to execute it.
Money and customer-visible actions use a two-call confirmation flow by default. The agent can make both calls: this is not proof of human approval. Use client-side approvals or the separate approval controls described in safety configuration.
An idempotencyKey deduplicates the same tool and arguments within the configured retention period. Reuse the same key for the same intended operation. If the outcome is uncertain, reconcile with Avito before retrying or choosing a new key.
Credentials go directly to Avito; there is no project-operated proxy or telemetry. Tool results are visible to your AI client and may be sent to its model provider under that client's settings.

Business calls use the real Avito account. Start with reads and previews. Ready-to-use safety configurations describe stronger approval controls, upload boundaries and recovery.

Remote MCP over HTTP (OAuth 2.1)

For a hosted agent or several clients, use Streamable HTTP on your own HTTPS domain. Set AVITO_MCP_TRANSPORT=http, AVITO_MCP_HTTP_PUBLIC_URL=https://mcp.example.com, and a strong AVITO_MCP_OAUTH_OWNER_PASSWORD, together with the Avito credentials.

Deployment, OAuth, Caddy and nginx configuration. bearer and none modes do not claim conformance with the MCP authorization specification; use OAuth for clients that discover authorization automatically.

Avito webhook receiver

The optional receiver buffers incoming Avito events and exposes them through a tool and a subscribable resource. An external agent must consume those events and decide whether to respond. Receiver setup.

Protocol and compatibility

Protocol revisions

AVITO_MCP_PROTOCOL_ERA selects legacy (default, MCP 2025-11-25), dual (both revisions), or modern (MCP 2026-07-28). A default stdio installation keeps serving the legacy revision; enabling the newer revision is explicit.

AVITO_MCP_HTTP_MAX_SESSIONS and AVITO_MCP_HTTP_SESSION_IDLE_SEC apply to legacy 2025-11-25 only. Modern HTTP uses AVITO_MCP_HTTP_MAX_INFLIGHT and AVITO_MCP_HTTP_MAX_STREAMS instead. Protocol details and limits.

Public tool names, documented valid arguments, environment variables, resource URIs and prompt names follow SemVer. See versioning details, migration from 1.3.x, and CHANGELOG.

Security

Token-returning tools and image uploads stay hidden until explicitly enabled. Tokens and runtime state are stored locally with restricted file permissions. Safety configuration, security policy and private reporting, and operational diagnostics describe the boundaries.

Install from source

git clone https://github.com/elchin92/avito-mcp.git

cd avito-mcp npm ci cp .env.example .env

Fill in your credentials locally.

npm run build:release

Configure your client to run node /absolute/path/to/dist/server.js. Pass creden

冒頭だけを表示しています。続きはリポジトリで読めます

Avito MCP

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

ネットショップ・決済のほかのサーバーとの比較i

よくある質問

代わりの候補

Spree Commerce: open-source B2B and marketplace ecommerce

Stripe MCP

MCP Cn Commerce

作者のREADME

avito-mcp

Try without Avito credentials

What you can do

Quick start

1. Prepare your account

2. Add the server to your client

3. Check a real read

Connect your AI client

API coverage

Safety and retries

Remote MCP over HTTP (OAuth 2.1)

Avito webhook receiver

Protocol and compatibility

Protocol revisions

Security

Install from source

Fill in your credentials locally.