trendyol-seller-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@trendyol-seller-mcp List my orders from the last 3 days"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| read | Paged product list, trimmed to |
| read | Order packages: |
| read | Customer Q&A: id, question text, status, product, existing answer. Other statuses: |
| write | Publishes an answer (10–2000 chars, per Trendyol's rules). Guarded — see below. |
| write | Batch stock/price update. |
| 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:
They refuse with a clear message unless the environment variable
TRENDYOL_ALLOW_WRITES=trueis set for the server process. Without it, the server is strictly read-only — an AI assistant cannot change your store.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 |
| yes | Your seller (cari) ID. |
| yes | API key from Entegrasyon Bilgileri. |
| yes | API secret from Entegrasyon Bilgileri. |
| no | Defaults to |
| no | Set to |
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 callsClaude 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-mcpClaude 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_ordersredacts customer name and full shipping address by default and returns only the city; passinclude_pii=trueper call when you actually need it.get_customer_questionsandget_claimsnever 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_stockreturns Trendyol'sbatchRequestIdbut 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-Aftervalue 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 toolsanswer_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
Scored across 6 tools
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.
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.
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.
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
Related MCP Connectors
Run an eBay seller account from your AI assistant: orders, listings, stock, fees and payouts.
Run your Zepsell store from AI: sales, orders, products, stock, customers and discount codes.
Run storefronts, listings, orders, content, fulfillment, and analytics through AI.
Run your Salla store from any AI app: orders, sales, stock, products, prices and store design.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables eBay sellers to manage inventory, view orders, handle messages, and browse listings through AI assistants using eBay seller APIs.-
- AlicenseNot gradedqualityCmaintenanceEnables 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
- AlicenseNot gradedqualityCmaintenanceProvides AI assistants with tools to read and update OTTO Market orders, products, stock levels, returns, and prices via natural language.AGPL 3.0
- AlicenseAqualityBmaintenanceEnables 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.4228 npmMIT