Summary
Run a Trendyol seller account from an AI agent: products (Product v2 listing, creation, content, archive), stock and prices, buybox, batch results, shipment packages with status, tracking, carrier and invoice link, returns, customer questions and answers, categories, attributes and brands, addresses and finance settlements. Basic auth with the API key and secret.
Guided setup
Connect Trendyol to Microsoft Copilot in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Trendyol in the guided setup, then add your MCP URL to Microsoft Copilot. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
Try asking
Example prompts for Trendyol
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Trendyol, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Trendyol + Microsoft Copilot
Run a Trendyol seller account from an AI agent: products (Product v2 listing, creation, content, archive), stock and prices, buybox, batch results, shipment packages with status, tracking, carrier and invoice link, returns, customer questions and answers, categories, attributes and brands, addresses and finance settlements. Basic auth with the API key and secret.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
TRENDYOL_API_HOST, TRENDYOL_SELLER_ID, TRENDYOL_API_KEY, TRENDYOL_API_SECRET
Step 1 — Get credentials
- Sign in to the Trendyol seller panel (
partner.trendyol.com) with the master user (admin role). Only the master user sees the API key and secret. - Open your store name (top right) → Hesap Bilgilerim → Entegrasyon Bilgileri. Copy the Satıcı ID (a number) into
TRENDYOL_SELLER_ID, the API Key intoTRENDYOL_API_KEYand the API Secret Key intoTRENDYOL_API_SECRET. - Set
TRENDYOL_API_HOSTtohttps://apigw.trendyol.comfor your live store. The stage (test) hosthttps://stageapigw.trendyol.comneeds separate stage credentials and only answers IP addresses that Trendyol has whitelisted (others get 503), so it suits a self-hosted test installation, not your live store. - Only if you sell on an international Trendyol storefront, set
TRENDYOL_STOREFRONT_CODEto its two-letter country code. Leave it empty for Trendyol Turkey. - Install the connector and run
trendyol_list_stock_and_prices.
Orders use the v2 endpoint: trendyol_list_orders reads shipment packages through Trendyol's v2 order endpoint (/v2/orders), which Trendyol made mandatory on 15 October 2026, when the old order lists stop working. It reaches at most the last month, with a date window of at most 2 weeks (the last week when no dates are given) and only the first 10,000 packages of a filter, so the AI narrows the window or filters by status to see more.
Confirm first: price and stock updates, content changes, package status, tracking numbers, carrier changes, invoice links, approving returns, answering questions, archiving and creating products all act on your live store. The AI shows you what will change (barcodes with old and new values, the package and its lines, the answer text) and waits for your yes. Product writes are asynchronous: a success only means the request was queued, so the AI checks the outcome with trendyol_get_batch_request (results stay available for 4 hours).
Switched off at install: trendyol_delete_products (cannot be undone), trendyol_report_unsupplied (cancels order lines for the customer, cannot be undone) and trendyol_reject_claim_items (asks Trendyol to reject returned items).
Limits: at most 50 requests per 10 seconds on one endpoint, plus per-minute limits per service group that depend on your store's listing tier. One price and stock update takes up to 1,000 barcodes (at most 20,000 units per product, sale price not above list price), and Trendyol refuses the same request again within 15 minutes or more than 30 price updates a minute for one barcode. Finance lists need a transaction type and a window of at most 15 days.
Common errors: 401 with ClientApiAuthenticationException or basic.authorization.failed: wrong credentials (stage and production credentials differ). 403: check TRENDYOL_SELLER_ID, because Trendyol needs a User-Agent built from it. 429 too.many.requests: wait a moment and try again.
The connector does not use the old api.trendyol.com/sapigw host, the old order lists or the old product filter.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in Microsoft Copilot
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Microsoft Copilot uses MCP servers through agents built in Copilot Studio: you add AnythingMCP to an agent as a tool, then publish the agent to Microsoft 365 Copilot and Teams. Copilot Studio connects from Microsoft's cloud over Streamable HTTP, which AnythingMCP supports.
- In Copilot Studio, open your agent (or create one), go to Tools and choose Add a tool → New tool → Model Context Protocol.
- Enter a Server name (for example
AnythingMCP), a Server description that says what the connector does, and the Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio uses the description to decide when to call the server. - Under authentication, choose API key, set Type to Header and the header name to
X-API-Key, then select Create. - In Add tool, choose Create a new connection, paste an MCP API key from AnythingMCP (MCP Servers → your server → API keys) and select Add to agent.
- Try it in the agent's Test pane: ask for something that needs the
Trendyoltools. - Select Publish, then Channels → Microsoft 365 and Microsoft Teams, keep Make agent available in Microsoft Copilot selected and choose Add channel. See agent in Teams installs it for you; in Microsoft 365 Copilot, type @ and pick the agent.
Prefer per-user sign-in? Choose OAuth 2.0 → Dynamic discovery instead of an API key: each user then signs in to AnythingMCP the first time the agent calls it.
Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Copilot Studio connects from Microsoft's cloud, so localhost does not work.
Available tools
| Tool | What it does |
|---|---|
trendyol_list_products | List the seller's approved products (Product v2 filter): one entry per content (productMainId, title, brand, category, images, attributes)… |
trendyol_list_unapproved_products | List products that are not approved yet: pending approval or rejected, with the reject reasons, price, stock and attributes |
trendyol_list_stock_and_prices | List only stock and prices of approved products (list price, sale price, quantity, last stock change per variant) |
trendyol_get_product | Read the basic state of one product by barcode: approved or not (and when), archived, listing id and content id |
trendyol_get_buybox | Check the buybox for up to 10 barcodes: your position in the buybox, the buybox price and whether other sellers offer the same product |
trendyol_get_batch_request | Read the result of an asynchronous product, price, stock, archive or delete request by its batchRequestId: overall status (IN_PROGRESS… |
trendyol_create_products | Create products (Product v2, up to 1,000 per call) |
trendyol_update_price_and_inventory | Update the stock and prices of approved products (up to 1,000 barcodes per call, at most 20,000 units per product) |
trendyol_update_product_content | Update the content of approved products (title, description, images, attributes) by contentId, up to 1,000 per call |
trendyol_update_unapproved_products | Correct products that are still waiting for approval or were rejected (title, description, brand, category, images, attributes, stock code… |
trendyol_archive_products | Archive products (take them off sale) or bring them back from the archive, by barcode, up to 1,000 per call |
trendyol_delete_products | Delete products from Trendyol by barcode |
trendyol_list_orders | List shipment packages (orders) with their lines, customer, addresses, amounts, status, cargo provider and tracking |
trendyol_update_package_status | Move a shipment package to Picking (you started preparing it) or Invoiced (with the invoice number) |
trendyol_update_tracking_number | Send the carrier's tracking number of a package shipped with your own carrier, mainly on the international storefronts (Europe, Gulf)… |
trendyol_change_cargo_provider | Change the cargo company of a shipment package |
trendyol_send_invoice_link | Send the link of the e-invoice (e-Fatura or e-Arşiv) of a shipment package; Trendyol forwards it to the customer |
trendyol_report_unsupplied | Report that lines of a package cannot be supplied, which cancels them for the customer |
trendyol_list_claims | List returns (claims) with the order, customer, cargo tracking and each returned item with the customer reason and status |
trendyol_get_claim_item_audit | Read the status history of one returned item: each status change, when and by whom |
trendyol_list_claim_issue_reasons | List the reasons a seller can give when rejecting a returned item, with their ids for trendyol_reject_claim_items |
trendyol_approve_claim_items | Approve returned items that arrived at your warehouse; the customer is refunded |
trendyol_reject_claim_items | Open a rejection request for returned items (for example a wrong or damaged item came back), with a reason from… |
trendyol_list_questions | List customer questions about your products: text, product, status (WAITING_FOR_ANSWER to answer), date and the answer if any |
trendyol_get_question | Read one customer question with the product, the answer and, if it was rejected or reported, the reason |
trendyol_answer_question | Answer a customer question (10 to 2,000 characters) |
trendyol_list_categories | Find categories for product creation |
trendyol_get_category_attributes | List the attributes of a leaf category: id, name, whether it is required, a variant attribute, allows several values or a free value |
trendyol_list_attribute_values | List the allowed values of one category attribute (attributeValueId and name), for attributeValueIds in trendyol_create_products |
trendyol_search_brands | Find brands by name to get the brandId for trendyol_create_products |
trendyol_list_brands | List all brands page by page (id and name) |
trendyol_list_cargo_providers | List the cargo companies available on the storefront (code and name) |
trendyol_list_addresses | List the seller's shipment, invoice and return addresses with their ids (shipmentAddressId and returningAddressId for products) and the… |
trendyol_list_settlements | List settlement lines: sales, returns, discounts, coupons, commissions and their payout, with amounts, commission rate, seller revenue… |
trendyol_list_other_financials | List other financial records: payment orders (payouts), wire transfers, incoming transfers, deduction and return invoices, commission… |
Example prompts
- "Which shipment packages from the last 3 days are still in status Created, and which lines does each one contain?"
- "Check the buybox for barcodes 8680001234567 and 8680001234574 and tell me whether another seller has the buybox and at what price."
- "List the customer questions waiting for an answer and draft a reply for each, but show me the answers before you send any of them."
- "Sum up our sales, returns and commissions from the settlements of 1 to 15 October."
FAQ
Which Copilot is this for? Microsoft 365 Copilot at work, through agents built in Copilot Studio. The Microsoft Copilot app for personal accounts has no option to add your own MCP server.
What do I need? A work account with access to Copilot Studio (a license or a trial) to build the agent. People who use it in Microsoft 365 Copilot or Teams need access to the agent: share it with them, or ask an admin to publish it to the organization. If your organization applies data policies to Power Platform connectors, they cover MCP servers too.
The agent doesn't call the tools. Check that the header name is exactly X-API-Key and that the key belongs to the same MCP server as the URL, and make the server description specific: Copilot Studio uses it to decide when to call the server. Publish the agent again after each change; in an open chat, type "start over" to get the new version.
Next steps
- Connector landing page
- Connect to Claude
- Connect to ChatGPT
- Connect to Cursor
- Connect to Gemini
- Connect to Meta Muse
Was this guide helpful?