Connector guide8-minute read35 MCP tools7 languages

How to Connect Trendyol to Cursor via MCP

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.

HCBy HelpCode teamUpdated 8 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

Trendyol

Trendyol

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.

tools

35

Region

INTL

Category

E-commerce

Authentication

Basic Auth

Required env vars

TRENDYOL_API_HOSTTRENDYOL_SELLER_IDTRENDYOL_API_KEYTRENDYOL_API_SECRET
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Skip the install. Get this working in under 2 minutes.

Start a free trial on cloud.anythingmcp.com, add the Trendyol in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.

Start free trial

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.

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.

Trendyol · live via MCP
Share
Opus 4.7

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 + Cursor

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

  1. 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.
  2. Open your store name (top right) → Hesap Bilgilerim → Entegrasyon Bilgileri. Copy the Satıcı ID (a number) into TRENDYOL_SELLER_ID, the API Key into TRENDYOL_API_KEY and the API Secret Key into TRENDYOL_API_SECRET.
  3. Set TRENDYOL_API_HOST to https://apigw.trendyol.com for your live store. The stage (test) host https://stageapigw.trendyol.com needs 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.
  4. Only if you sell on an international Trendyol storefront, set TRENDYOL_STOREFRONT_CODE to its two-letter country code. Leave it empty for Trendyol Turkey.
  5. 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 Cursor

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 shows YOUR_SERVER_ID.

Cursor reads MCP servers from ~/.cursor/mcp.json. Add this entry:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
  2. Save the file and restart Cursor.
  3. Open Cursor → Settings → MCP and check that anythingmcp is listed and connected.
  4. Start chatting: the agent can now call the Trendyol tools.

Available tools

ToolWhat it does
trendyol_list_productsList the seller's approved products (Product v2 filter): one entry per content (productMainId, title, brand, category, images, attributes)…
trendyol_list_unapproved_productsList products that are not approved yet: pending approval or rejected, with the reject reasons, price, stock and attributes
trendyol_list_stock_and_pricesList only stock and prices of approved products (list price, sale price, quantity, last stock change per variant)
trendyol_get_productRead the basic state of one product by barcode: approved or not (and when), archived, listing id and content id
trendyol_get_buyboxCheck 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_requestRead the result of an asynchronous product, price, stock, archive or delete request by its batchRequestId: overall status (IN_PROGRESS…
trendyol_create_productsCreate products (Product v2, up to 1,000 per call)
trendyol_update_price_and_inventoryUpdate the stock and prices of approved products (up to 1,000 barcodes per call, at most 20,000 units per product)
trendyol_update_product_contentUpdate the content of approved products (title, description, images, attributes) by contentId, up to 1,000 per call
trendyol_update_unapproved_productsCorrect products that are still waiting for approval or were rejected (title, description, brand, category, images, attributes, stock code…
trendyol_archive_productsArchive products (take them off sale) or bring them back from the archive, by barcode, up to 1,000 per call
trendyol_delete_productsDelete products from Trendyol by barcode
trendyol_list_ordersList shipment packages (orders) with their lines, customer, addresses, amounts, status, cargo provider and tracking
trendyol_update_package_statusMove a shipment package to Picking (you started preparing it) or Invoiced (with the invoice number)
trendyol_update_tracking_numberSend the carrier's tracking number of a package shipped with your own carrier, mainly on the international storefronts (Europe, Gulf)…
trendyol_change_cargo_providerChange the cargo company of a shipment package
trendyol_send_invoice_linkSend the link of the e-invoice (e-Fatura or e-Arşiv) of a shipment package; Trendyol forwards it to the customer
trendyol_report_unsuppliedReport that lines of a package cannot be supplied, which cancels them for the customer
trendyol_list_claimsList returns (claims) with the order, customer, cargo tracking and each returned item with the customer reason and status
trendyol_get_claim_item_auditRead the status history of one returned item: each status change, when and by whom
trendyol_list_claim_issue_reasonsList the reasons a seller can give when rejecting a returned item, with their ids for trendyol_reject_claim_items
trendyol_approve_claim_itemsApprove returned items that arrived at your warehouse; the customer is refunded
trendyol_reject_claim_itemsOpen a rejection request for returned items (for example a wrong or damaged item came back), with a reason from…
trendyol_list_questionsList customer questions about your products: text, product, status (WAITING_FOR_ANSWER to answer), date and the answer if any
trendyol_get_questionRead one customer question with the product, the answer and, if it was rejected or reported, the reason
trendyol_answer_questionAnswer a customer question (10 to 2,000 characters)
trendyol_list_categoriesFind categories for product creation
trendyol_get_category_attributesList 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_valuesList the allowed values of one category attribute (attributeValueId and name), for attributeValueIds in trendyol_create_products
trendyol_search_brandsFind brands by name to get the brandId for trendyol_create_products
trendyol_list_brandsList all brands page by page (id and name)
trendyol_list_cargo_providersList the cargo companies available on the storefront (code and name)
trendyol_list_addressesList the seller's shipment, invoice and return addresses with their ids (shipmentAddressId and returningAddressId for products) and the…
trendyol_list_settlementsList settlement lines: sales, returns, discounts, coupons, commissions and their payout, with amounts, commission rate, seller revenue…
trendyol_list_other_financialsList 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

Does Cursor support custom MCP servers on the free tier? Yes, MCP is available on Hobby, Pro and Business plans.

Next steps

Was this guide helpful?

Your Trendyol agent is one click away.

Install the connector, paste the key, prompt Cursor. Free for 7 days, no credit card.

Related guides

Connectors

How to Connect Trendyol to ChatGPT via MCP

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.

Connectors

How to Connect Trendyol to Claude via MCP

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.

Connectors

How to Connect Trendyol to Gemini via MCP

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.

Connectors

How to Connect Trendyol to Meta Muse via MCP

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.

Connectors

Trendyol to MCP: Drive Trendyol from any AI Agent

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.

Connectors

How to Connect Avito to Cursor via MCP

Let your AI work with your Avito business account: list your ads and change their prices, read views, contacts and calls statistics, check autoload uploads and their errors, the feed format and your wallet, and read Avito Messenger chats. Sending messages and changing autoload settings are optional and off by default.