Skip to main content
Glama
trendyol-seller-mcp

trendyol-seller-mcp

trendyol-seller-mcp

An unofficial MCP server for the Trendyol Marketplace seller API, so Turkish e-commerce sellers can drive day-to-day store operations from an AI assistant (Claude Desktop, Claude Code, or any other MCP client): list products, check order packages, review returns, and — when explicitly enabled — answer customer questions and update stock/prices.

Not affiliated with Trendyol. This is an independent open-source project by Koray Nar (Istanbul). It talks to the official seller API using your own API credentials, which you can find in the Trendyol Seller Panel: Satıcı Paneli > Hesap Bilgilerim > Entegrasyon Bilgileri (visible only to the panel's master user).

Built by Koray to support his own AI-automation practice and published as part of his public portfolio. It is a working tool with a mocked test suite — no user counts, clients, or production claims implied.

Türkçe Özet

trendyol-seller-mcp, Trendyol Pazaryeri satıcı API'si için resmi olmayan bir MCP sunucusudur. Claude gibi bir yapay zeka asistanının mağazanızla konuşmasını sağlar: ürünleri listeler, sipariş paketlerini ve iadeleri görüntüler, müşteri sorularını okur. Yazma işlemleri (soru cevaplama, stok/fiyat güncelleme) varsayılan olarak kapalıdır; yalnızca TRENDYOL_ALLOW_WRITES=true ortam değişkenini ayarlarsanız çalışır.

Gerekli bilgiler: Satıcı ID, API Key ve API Secret — bunları Satıcı Paneli > Hesap Bilgilerim > Entegrasyon Bilgileri sayfasında bulabilirsiniz. Proje Trendyol ile bağlantılı değildir; kendi API bilgilerinizle, kendi sorumluluğunuzda kullanılır. Sipariş verilerinde müşteri adı ve adresi varsayılan olarak gizlenir (yalnızca şehir gösterilir).

Related MCP server: E-commerce MCP Server

Tools

Tool

Type

What it does

get_products(page=0, size=50, approved=None, barcode="")

read

Paged product list, trimmed to barcode, title, quantity, salePrice, listPrice, approved.

get_orders(status="", start_date="", end_date="", page=0, size=50, include_pii=False)

read

Order packages: orderNumber, status, orderDate, totalPrice, lines, and customer city only. Name/full address are redacted unless include_pii=True. Dates accept YYYY-MM-DD or epoch ms. Status values: Created, Picking, Invoiced, Shipped, Cancelled, Delivered, UnDelivered, Returned, AtCollectionPoint, UnSupplied.

get_customer_questions(status="WAITING_FOR_ANSWER", page=0, size=50)

read

Customer Q&A: id, question text, status, product, existing answer. Other statuses: WAITING_FOR_APPROVE, ANSWERED, REPORTED, REJECTED.

answer_question(question_id, text)

write

Publishes an answer (10–2000 chars, per Trendyol's rules). Guarded — see below.

update_price_and_stock(items_json)

write

Batch stock/price update. items_json is a JSON array of {"barcode", "quantity", "salePrice", "listPrice"} (max 1000 items). Returns Trendyol's batchRequestId. Guarded — see below.

get_claims(page=0, size=20)

read

Returns/claims summary with per-item status and customer reason. Customer names excluded.

Write guard (read this first)

The two write tools are double-guarded:

  1. They refuse with a clear message unless the environment variable TRENDYOL_ALLOW_WRITES=true is set for the server process. Without it, the server is strictly read-only — an AI assistant cannot change your store.

  2. Client-side validation runs before any request leaves your machine (answer length 10–2000 characters, max 1000 items per stock/price batch, barcode required per item).

Recommended: run read-only first, and only set TRENDYOL_ALLOW_WRITES=true once you trust the workflow. Answers to customer questions are public and can only be posted once per question.

Configuration

Env var

Required

Meaning

TRENDYOL_SELLER_ID

yes

Your seller (cari) ID.

TRENDYOL_API_KEY

yes

API key from Entegrasyon Bilgileri.

TRENDYOL_API_SECRET

yes

API secret from Entegrasyon Bilgileri.

TRENDYOL_BASE_URL

no

Defaults to https://apigw.trendyol.com/integration. Set to https://stageapigw.trendyol.com/integration for Trendyol's stage environment.

TRENDYOL_ALLOW_WRITES

no

Set to true to enable the two write tools. Anything else keeps them disabled.

Requests use HTTP Basic auth (key/secret) and the User-Agent Trendyol requires for self-integrations: "<sellerId> - SelfIntegration".

Quickstart

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 Desktop

Add to 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 write tools active.

Privacy notes

  • get_orders redacts customer name and full shipping address by default and returns only the city; pass include_pii=true per call when you actually need it.

  • get_customer_questions and get_claims never return customer names.

  • Credentials come from environment variables only; nothing is written to disk.

Limitations (honest list)

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

  • Covers six common operations, not the full API surface (no product creation, shipping label, invoice, or webhook endpoints).

  • update_price_and_stock returns Trendyol's batchRequestId but does not poll the batch result endpoint; check the batch status yourself if needed.

  • Trendyol's docs cap question pages at 50 items and order pages at 200; this server clamps to those. No documented cap was found for the product filter (V1) page size, so it is passed through as-is.

  • Trendyol's international (non-TR) marketplace API is not targeted or tested.

  • No caching, no retry loop — a 429 is surfaced with the Retry-After value so the calling assistant can decide when to retry.

  • Built and tested against mocked responses; field names include tolerant fallbacks where Trendyol's docs show more than one name for the same field.

License

MIT © 2026 Koray Nar

Available Tools

6 tools
answer_questionA

WRITE: publish an answer to a customer question on Trendyol.

Refuses unless the environment variable TRENDYOL_ALLOW_WRITES=true is set. The answer is shown publicly to customers; Trendyol requires 10-2000 characters and questions can only be answered once.

Args: question_id: The question id from get_customer_questions. text: The answer text (10-2000 characters).

Inputs: text (required), question_id (required). Returns: object

get_claimsA

List returns/claims (iade talepleri) for the store (read-only).

Args: page: Zero-based page number. size: Items per page.

Returns claim id, orderNumber, claimDate, overall status and per-item status/reason summaries. Customer names are not included.

Inputs: page, size. Returns: object

get_customer_questionsA

List customer questions about the store's products (read-only).

Args: status: One of WAITING_FOR_ANSWER, WAITING_FOR_APPROVE, ANSWERED, REPORTED, REJECTED. Default lists questions awaiting an answer. page: Zero-based page number. size: Items per page, max 50.

Returns question id, text, status, creationDate, productName and webUrl, plus the existing answer text when one exists. Customer user names are not included.

Inputs: page, size, status. Returns: object

get_ordersA

List order packages (shipment packages) for the store (read-only).

Args: status: Optional filter. Documented values: Created, Picking, Invoiced, Shipped, Cancelled, Delivered, UnDelivered, Returned, AtCollectionPoint, UnSupplied. start_date: 'YYYY-MM-DD' or epoch milliseconds. end_date: 'YYYY-MM-DD' (inclusive) or epoch milliseconds. page: Zero-based page number (API allows pages 0-49). size: Items per page, max 200. include_pii: Customer name and full shipping address are REDACTED by default; set True only when personal data is genuinely needed.

Returns a paged summary: orderNumber, status, orderDate, totalPrice, order lines, and the customer's city only (unless include_pii=True).

Inputs: page, size, status, end_date, +2 more. Returns: object

get_productsA

List products in the seller's Trendyol store (read-only).

Args: page: Zero-based page number. size: Items per page (the sibling V2 endpoint caps at 100; no explicit cap is documented for this V1 filter). approved: True for approved products only, False for unapproved only, omit for both. barcode: Filter by an exact product barcode.

Returns a paged summary with barcode, title, quantity, salePrice, listPrice and approved per product.

Inputs: page, size, barcode, approved. Returns: object

update_price_and_stockA

WRITE: batch-update stock quantity and/or prices for existing products.

Refuses unless the environment variable TRENDYOL_ALLOW_WRITES=true is set.

Args: items_json: JSON array of item objects, e.g. '[{"barcode": "BC123", "quantity": 10, "salePrice": 99.9, "listPrice": 129.9}]' Each item needs "barcode"; "quantity", "salePrice" and "listPrice" are optional (update only what you send). Max 1000 items per call.

Returns the batchRequestId Trendyol assigns; the update is processed asynchronously on their side.

Inputs: items_json (required). Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool addresses a distinct resource: products, orders, customer questions, claims, and price/stock updates. Though get_customer_questions and answer_question are related, they clearly separate read and write concerns, so no ambiguity exists.

    Naming Consistency5/5

    Tool names follow a consistent verb-noun pattern: get_* for read-only operations, and action verbs like answer_ and update_ for writes. The naming is uniform and predictable, enhancing usability.

    Tool Count5/5

    With 6 tools, the server is well-scoped for a seller-focused MCP. Each tool serves a clear purpose without redundancy, and the count is within the ideal 3-15 range for a domain-specific integration.

    Completeness4/5

    The surface covers key seller operations: product listing, order viewing, customer Q&A, price/stock updates, and claims. Minor gaps exist (e.g., no product creation/deletion or order detail individual view), but the provided tools support common workflows effectively.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables connecting 13 e-commerce platforms such as Amazon, eBay, WooCommerce, and OTTO to Claude, ChatGPT, Copilot, and Cursor, exposing 160 tools to manage stores, orders, products, and marketplaces through natural language.
      AGPL 3.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables LLMs to manage e-commerce seller workflows through natural language, including marketplace search, listing publication and updates, buyer questions, orders, shipping labels, messages, claims, reputation metrics, catalog, promotions, ads, and fulfillment operations. Provides 42 tools with OAuth authentication and a security layer.
      42
      28 npm
      MIT