trendyol-seller-mcp

Неофициальный MCP сервер для API продавца Trendyol Marketplace, который позволяет туреским продавцам e-commerce управлять повседневными операциями магазина через AI-ассистента (Claude Desktop, Claude Code или любой другой MCP-клиент): выводить списки товаров, проверять пакеты заказов, просзывать возвraты and — при явном вклю rejected — отвечать покупателей and update остаки/цены.

Trendyol is not associated with Trendyol. This is an independent open-source project by Korь-Nar (IG). Оно ра advances Tar API with its own API credentials, which can be found in Trendyol Seller Panel: Satıcı Panec > Hesap Bilgilerim > Eğraasyon Bilgiler (available only to master user).

Created by Koray, to support his own AI-automation practice, and published in his open portfolio. It is a working tool with a mock test suite — no claims of number of users, clients, or production load.

Türkçe Özet

rendyol-seller-mcp is неофициальный MCP-сервер for API клиента Trendyol Market. Он позволяет искусственно-ассистенту, такому как Claude, общается с we мазinen: lists товары, отображает пакети заказов и заявки на возврат, читает вопросы покупателей. Записывающие операции (отвечи на вопросы, обновление осатка/цены) по умолчанию отключены; они работают только если задать ** TRENDYOL_ALLOW_WEITES=true окuent environment **.

Необходиsые данные: Satıcıcordinate, API Key and API Secret — они can be find in the page Satıcı Paneli > Seaсведения Bilimlerim > Qğrasyon Bilgiler (Сaidıcıcı ID, API-клю activation, API секрет). The project not connects with Trendyol: use with own API-ключи and on own responsibility. In the order data the buyer's last name/address are hidden by default (only city is displayed).

Related MCP server: Yandex Market Seller MCP Server

Tools

Write guard (read first)

The two tools of records are bouble (two level of protection) :

1. They refuse with visible message, unless the environment variable TRENDYOL_ALLOW_WRITES=true is installed in the server process. Without it server is strictly read-only — an artificial assistant cannot change your store.

2. Validation on client side runs before any request leaves your machine (answer length 10–2000 characters, maximum 1000 items per stock/price pack, barcode required for each item).

Recommendation: run first in read-only mode and only then set TRENDYOL_ALLOW_WRITES=true if you have trusted the workflow. Answers to customer questions are available and can be sent only once per question.

Config

Requests are sent with HTTP Basic auth (key/secret) and the User-Agent type required by Trendyol for self-integrations: " <sellerId> - SelfIntegration".

Kishkstart

Requires Python 3.11+ and uv.

git clone https://github.com/koraynar/trendyol-seller-mcp
cd trendyol-seller-mcp
uv venv && uv pip install -e '.[dev]'
uv run --extra dev pytest   # all tests are offline (httpx.MockTransport), no live calls

Claude Code

claude mcp add trendyol-seller \
  --env TRENDYOL_SELLER_ID=123456 \
  --env TRENDYOL_API_KEY=your-key \
  --env TRENDYOL_API_SECRET=your-secret \
  -- uv run --directory /absolute/path/to/trendyol-seller-mcp trendyol-seller-mcp

Claude Deskptop

Add in claude_desktop_config.json:

{
  "mcpServers": {
    "trendyol-seller": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/trendyol-seller-mcp",
        "trendyol-seller-mcp"
      ],
      "env": {
        "TRENDYOL_SELLER_ID": "123456",
        "TRENDYOL_API_KEY": "your-key",
        "TRENDYOL_API_SECRET": "your-secret"
      }
    }
  }
}

Add "TRENDYOL_ALLOW_WRITES": "true" to env only when you want the record tools to be active.

Privacy notes

• get_orders hides the customer's name and full delivery address by default and returns only the city; pass include_pii=true in the call only if you really need it.

• get_customer_questions and get_claims never return customer names.

• credentials come only from environment variables; nothing is stored on disk.

Limitations (honest list)

• Unofficial: Trendyol can change API at any time; endpoints were verified against developers.trendyol.com (v2.0, EN) on 2026-08-25.

• covers seven standard operations, not full API surface (no endpoint for product creation, delivery labels, invoices or webhooks).

• update_and_stock returns Trendyol's batchRequestId, but does not poll that batch result; check the status of batch if necessary.

• Trendyol docs establish max 50 items for question pages and 200 items for order pages; server is limited to these limits. No documented restriction was found for page size of filter (V2) and it is passed as is.

• Trendyol's international (non-Tur ) Marketplace API not supported/ not tested.

• No caching, no retry cycle — 429 is returned with ValRetry-After value so that the talking assistant can decide when to retry.

• Built and tested on mock responses; field names have stable fallbacks in cases where Trendyol documentation shows more than one name for same field.

License

MIT © 2026 Koray N ar.