# Wb Mcp Server

> MCP server from dmitriykosik74-rgb/wb-mcp-server.

- **Type:** MCP server
- **Install:** `agentstack add mcp-dmitriykosik74-rgb-wb-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [dmitriykosik74-rgb](https://agentstack.voostack.com/s/dmitriykosik74-rgb)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [dmitriykosik74-rgb](https://github.com/dmitriykosik74-rgb)
- **Source:** https://github.com/dmitriykosik74-rgb/wb-mcp-server

## Install

```sh
agentstack add mcp-dmitriykosik74-rgb-wb-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# wb-mcp-server

[](https://www.npmjs.com/package/wb-mcp-server)
[](LICENSE)
[](https://t.me/dmkosik)

[Русская версия](README.ru.md)

**Author:** Дмитрий Косик · 📢 [Telegram channel @dmkosik](https://t.me/dmkosik) · 💬 [Contact author @feeyh](https://t.me/feeyh)

MCP server for the Wildberries Seller API. Connect any AI agent (Claude Desktop, OpenClaw, or any MCP client) to your Wildberries store.

## Quick Start

### 1. Install

```bash
npm install -g wb-mcp-server
```

### 2. Get a WB API token

Create an API token in your [WB Seller Dashboard](https://seller.wildberries.ru/) under **Settings > API Access**.

### 3. Add to Claude Desktop config

```json
{
  "mcpServers": {
    "wildberries": {
      "command": "wb-mcp-server",
      "env": {
        "WB_API_TOKEN": "your_token_here"
      }
    }
  }
}
```

> **Windows: `spawn wb-mcp-server ENOENT` error**
>
> If Claude Desktop can't find the `wb-mcp-server` command, use `npx` instead:
>
> ```json
> {
>   "mcpServers": {
>     "wildberries": {
>       "command": "npx",
>       "args": ["-y", "wb-mcp-server"],
>       "env": {
>         "WB_API_TOKEN": "your_token_here"
>       }
>     }
>   }
> }
> ```
>
> This commonly happens with the Microsoft Store version of Claude Desktop, which doesn't see the global npm packages path.

## Updating to the latest version

New versions are released regularly — for example, v0.4.0 added 10 new tools (acquiring report, sales summary, content cards, supplies, documents, seller info, item rating). The server does **not** auto-update — you need to update it manually.

### Step 1. Update the package

**If installed globally** (Claude Desktop config uses `"command": "wb-mcp-server"`):

```bash
npm install -g wb-mcp-server@latest
```

**If using `npx`** (Claude Desktop config uses `"command": "npx"`):

```bash
npx -y wb-mcp-server@latest
```

If `npx` keeps pulling an old cached version, clear the cache:

```bash
npm cache clean --force
```

### Step 2. Fully restart Claude Desktop

Quit the app **from the system tray** (not just closing the window), then reopen it. Otherwise Claude will keep using the old server process.

### Step 3. Verify the version

```bash
npm list -g wb-mcp-server
```

Or ask Claude: *"Which wb-mcp-server tools are available to you?"* — v0.4.3 should show 35 tools.

## Available Tools (35)

### Reviews & Questions

| Tool | Description | Type |
|---|---|---|
| `get_feedbacks` | Get customer reviews | read |
| `reply_feedback` | Reply to a review | **write** |
| `get_questions` | Get customer questions | read |
| `reply_question` | Reply to a question | **write** |
| `get_unanswered_count` | Count of unanswered reviews | read |

### Statistics & Analytics

| Tool | Description | Type |
|---|---|---|
| `get_stocks` | Warehouse stock levels | read |
| `get_orders` | Recent orders | read |
| `get_sales` | Sales data | read |
| `get_financial_report` | Detailed report: commissions, logistics, storage, penalties | read |
| `get_nm_report` | Per-product report (views, cart, orders, buyouts) | read |
| `get_warehouses_inventory` | Real-time warehouse inventory report (async) | read |
| `get_item_rating` | Seller rating + feedback increase by star | read |

### Advertising

| Tool | Description | Type |
|---|---|---|
| `get_advert_list` | Advertising campaigns list | read |
| `get_advert_stats` | Campaign statistics | read |
| `get_advert_balance` | Advertising account balance | read |
| `update_advert_bid` | Update campaign bids | **write** |

### Pricing

| Tool | Description | Type |
|---|---|---|
| `get_prices` | Product list with prices and discounts | read |
| `update_prices` | Update prices and discounts | **write** |

### Finance

| Tool | Description | Type |
|---|---|---|
| `get_seller_balance` | Current seller account balance | read |
| `get_sales_reports_summary` | Weekly sales report summaries (for dashboards) | read |
| `get_acquiring_report_list` | Acquiring expense report summaries | read |
| `get_acquiring_report` | Detailed acquiring (card-processing) fees | read |

### Product Cards

| Tool | Description | Type |
|---|---|---|
| `get_content_cards` | Product cards listing with cursor pagination | read |

### FBS Supplies

| Tool | Description | Type |
|---|---|---|
| `get_supplies` | FBS supplies list | read |
| `create_supply` | Create a new open FBS supply | **write** |

### FBW Supplies (to WB warehouses)

| Tool | Description | Type |
|---|---|---|
| `get_fbw_supplies` | FBW supplies list with numeric IDs (e.g. 38419461) | read |
| `get_fbw_supply` | FBW supply details: warehouse, dates, declared/accepted qty | read |
| `get_fbw_supply_goods` | **Supply composition by barcode** — for acceptance reconciliation | read |
| `get_fbw_supply_package` | Supply boxes layout | read |
| `get_wb_warehouses` | WB warehouses reference | read |
| `get_paid_acceptance_report` | Paid acceptance report (async) | read |
| `get_acceptance_coefficients` | WB warehouse acceptance coefficients for 14 days | read |

### Documents

| Tool | Description | Type |
|---|---|---|
| `get_documents` | Financial documents: invoices, reports, acts | read |

### Seller Info

| Tool | Description | Type |
|---|---|---|
| `get_seller_info` | Name, INN, trademark | read |
| `get_jam_subscription` | Jam subscription status (requires Service token) | read |

## Example prompts

Ask your AI agent (after connecting the MCP server):

- *"How many unanswered reviews do I have?"*
- *"Show me the seller rating and feedback breakdown by star for the last 2 weeks"*
- *"Give me a weekly P&L summary: payouts, logistics, storage, penalties"*
- *"List the latest financial documents (invoices, weekly reports)"*
- *"Show acquiring fees for the past month"*
- *"What's my current account balance and how much can I withdraw?"*
- *"Find product card by nmID 391083595"*
- *"List my open FBS supplies"*
- *"How many sales did I have last week?"*
- *"Which products convert best from views to orders?"*

## Configuration

| Variable | Description | Required |
|---|---|---|
| `WB_API_TOKEN` | Wildberries Seller API token | Yes |

Or pass via CLI: `wb-mcp-server --token=your_token`

## Development

```bash
git clone https://github.com/dmitriykosik74-rgb/wb-mcp-server.git
cd wb-mcp-server
npm install
npm test
npm run build
```

## Contributing

1. Fork the repo
2. Create a feature branch (`git checkout -b feature/my-feature`)
3. Commit your changes (`git commit -m 'feat: add my feature'`)
4. Push and create a Pull Request

## License

[MIT](LICENSE)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [dmitriykosik74-rgb](https://github.com/dmitriykosik74-rgb)
- **Source:** [dmitriykosik74-rgb/wb-mcp-server](https://github.com/dmitriykosik74-rgb/wb-mcp-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-dmitriykosik74-rgb-wb-mcp-server
- Seller: https://agentstack.voostack.com/s/dmitriykosik74-rgb
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.