Connector guide11-minute read29 MCP tools7 languages

Connect Rozetka to Meta Muse via MCP

Rozetka Marketplace seller API for Ukraine's largest marketplace: orders with status and waybill (TTN) updates, payment status, goods with mass price and stock updates and new listings, shop reviews and product questions with replies, buyer chats, and return requests. Signs in with the seller cabinet login.

HCBy HelpCode teamUpdated 11 min read Open-source on GitHub

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

Rozetka Marketplace

Rozetka Marketplace

Rozetka Marketplace seller API for Ukraine's largest marketplace: orders with status and waybill (TTN) updates, payment status, goods with mass price and stock updates and new listings, shop reviews and product questions with replies, buyer chats, and return requests. Signs in with the seller cabinet login.

tools

29

Region

INTL

Category

E-commerce

Authentication

Sign-in token

Required env vars

ROZETKA_USERNAMEROZETKA_PASSWORD_BASE64
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

Summary

Rozetka Marketplace seller API for Ukraine's largest marketplace: orders with status and waybill (TTN) updates, payment status, goods with mass price and stock updates and new listings, shop reviews and product questions with replies, buyer chats, and return requests. Signs in with the seller cabinet login.

Guided setup

Connect Rozetka Marketplace to Meta Muse in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Rozetka Marketplace in the guided setup, then add your MCP URL to Meta Muse. No code and no server to run.

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

Try asking

Example prompts for Rozetka Marketplace

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

Rozetka Marketplace · 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 → Rozetka Marketplace, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Rozetka Marketplace + Meta Muse

Rozetka Marketplace seller API for Ukraine's largest marketplace: orders with status and waybill (TTN) updates, payment status, goods with mass price and stock updates and new listings, shop reviews and product questions with replies, buyer chats, and return requests. Signs in with the seller cabinet login.

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:

ROZETKA_USERNAME, ROZETKA_PASSWORD_BASE64

Step 1 — Get credentials

The API signs in with the login and password of the Rozetka seller cabinet (seller.rozetka.com.ua); there is no separate API key.

  1. Put the cabinet login in ROZETKA_USERNAME.
  2. Rozetka expects the password Base64-encoded, so ROZETKA_PASSWORD_BASE64 takes the encoded form, not the plain password. Encode it on your own computer, e.g. in a terminal printf '%s' 'your-password' | base64, and paste the result. Do not use an online encoder for a real password. AnythingMCP logs in with POST /sites and sends the session token as a Bearer token. Rozetka keeps a token alive while it is used and lets it expire after 24 hours without use; the connector signs in again every four hours. A wrong login or password is reported as incorrect_username_password.

Where to start: rozetka_get_order_counts and rozetka_get_message_counts show what is waiting (new orders, unread chats, open return requests). Then rozetka_list_orders with types=4 (new) or types=2 (in processing).

Orders

  • rozetka_list_order_statuses maps the numeric status of an order to its name. rozetka_list_orders filters by types (1 all, 2 in processing, 3 completed, 4 new, 5 being delivered, 6 failed), status or dates; rozetka_get_order reads one order. Add expand=purchases,delivery,user for items, delivery and buyer, and status_available for the statuses the order may move to next.
  • rozetka_update_order changes the status, adds the waybill (TTN) and a seller comment. Usual flow: new order (1) -> confirm with 2 (being packed) -> add the TTN with status 3 (handed to the carrier) or 61 (handover planned); a TTN sent with status 2 moves the order to 61. After a TTN is added Rozetka tracks the parcel and moves the status itself. Statuses 7 and above are mostly cancellations or delivery states (e.g. 16/42 out of stock, 18 buyer unreachable, 40 buyer changed their mind, 45 cancelled by the buyer): set a cancellation only when the seller asks, it cannot be undone. Check status_available first.
  • rozetka_get_order_payment_status tells whether an online payment is paid, unpaid, being checked or cancelled (cached 5 minutes).

Goods and prices

  • rozetka_list_goods and rozetka_get_goods read the seller's goods; rozetka_get_goods_counts counts them per cabinet tab (errors, moderation, waiting for confirmation).
  • rozetka_update_goods_price_stock changes price and stock for one or many goods by item_rz_id (the Rozetka id, id/rz_item_id in the goods list, not the internal item_id). Prices are in UAH. Rozetka holds a price raised more than 1.5 times or cut by more than half for a manager to confirm.
  • Goods status ids: 0 locked, 1 active, 2 new, 3 queued for moderation, 4 being moderated, 5 rejected by moderation, 6 needs moderator confirmation, 7 archived, 8 waiting for moderation. Sell status: 0 unavailable, 1 supply expected, 2 call, 3 running out, 4 available, 5 archive, 6 strictly unavailable, 7 out of stock, 8 hidden.
  • New listing: rozetka_list_goods_categories (find the category; is_vendor_required 1 means a producer is mandatory) -> rozetka_list_category_attributes (its characteristics; raise pageSize, the API returns 5 by default) -> rozetka_list_attribute_values (allowed values for list-type characteristics) -> rozetka_list_producers -> rozetka_create_goods with Russian and Ukrainian name, price, stock and picture URLs. New goods go through Rozetka moderation before they are shown.

Reviews, questions and chats

  • Shop reviews: rozetka_list_store_reviews (e.g. reply_search=0 for reviews without an answer, vote=dislike for negative ones), then rozetka_reply_store_review with the review id and its order_id.
  • Product reviews and questions: rozetka_list_goods_comments with isAnswered=0 lists threads waiting for the seller; answer with rozetka_reply_goods_comment (parent_id = comment id, item_id = item.id).
  • Chats: rozetka_list_chats (msgType=orders for order chats, items for product questions, has_response_to_user=0 for unanswered ones), rozetka_get_chat to read the messages (this marks them read), rozetka_get_order_chat to find the chat of an order, and rozetka_send_message with chat_id and the buyer's user_id as receiver_id.
  • Replies, answers and messages are public or reach the buyer: draft the text, show it to the seller and send only after they agree. Write in the buyer's language, usually Ukrainian. Replies and product answers are moderated by Rozetka before they appear.

Returns: rozetka_list_refund_requests (status codes from rozetka_list_refund_statuses), rozetka_get_refund_request for the reason, the decision the buyer wants and the chat, and rozetka_save_refund_ttn to store the return waybill. rozetka_update_refund_status (accept or reject a request) is installed switched off, because accepting can refund the buyer; an admin turns it on deliberately. Return request ids contain letters (e.g. AM1234567).

Not included: balances, invoices, payments, fiscal receipts (PRRO), paid waybill creation with carriers, manager accounts and deletions. The connector never moves money.

Formats and gotchas

  • Rozetka answers HTTP 200 even when a call fails, with success: false; the connector turns that into an error carrying errors.message and errors.code, e.g. incorrect_access_token (1020) or access_denied (1010, the account's role lacks the right).
  • Prices are in UAH. Dates in filters are YYYY-MM-DD; timestamps come as YYYY-MM-DD HH:MM:SS without a time zone.
  • Texts come in the cabinet's language (Ukrainian or Russian); return requests answer in Ukrainian.

Pagination and limits: lists sit under content with _meta (totalCount, pageCount, currentPage, perPage). Call again with page + 1 until currentPage equals pageCount. Orders, reviews and chats come 20 per page; goods, categories and directories accept pageSize. No rate limit is published; avoid tight loops and prefer one mass update over many single ones.

Cloud reachability: api-seller.rozetka.com.ua is public over HTTPS, reachable from AnythingMCP Cloud and from self-hosted installs.

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 Muse

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.

Muse adds remote MCP servers as custom connectors and signs in to them with OAuth.

  1. In Muse, open Settings → Connectors and choose Add custom connector.
  2. Paste the MCP server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
  3. Muse opens the AnythingMCP sign-in page: sign in and approve access.
  4. In a chat, ask Muse for something that needs the Rozetka Marketplace tools.

You can also set it up from a chat, on the web, in the iOS and Android apps or in WhatsApp. Send Muse this message:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Muse connects from Meta's cloud, so localhost does not work.

Available tools

ToolWhat it does
rozetka_list_ordersSearch the seller's Rozetka orders, 20 per page, by status group, status, creation or change date, order id, buyer phone or waybill (TTN).…
rozetka_get_orderGet one Rozetka order by id with amounts, status and comments. Use expand for items (purchases), delivery, buyer (user), status history…
rozetka_list_order_statusesList Rozetka order statuses with id, Ukrainian, Russian and English name and status group, to read the numeric status of an order
rozetka_list_goodsSearch the seller's goods on Rozetka (all tabs) by name, text, article, price-list id or Rozetka id, availability or category. Returns ids…
rozetka_get_goodsGet the details of one of the seller's goods on Rozetka (prices, category, description, stock state) by the internal item_id or by…
rozetka_update_orderChange the status of a Rozetka order, add the waybill number (TTN) and/or a seller comment. Returns the updated order. A TTN is required…
rozetka_get_order_countsCount the seller's Rozetka orders by group: inProgress (in processing), new, delivering, inDone (completed), inNotDone (failed), unwatched…
rozetka_get_order_payment_statusGet the current payment status of an order paid online: status_payment_id, name (paid, unpaid, cancelled, unapproved, part-paid ...)…
rozetka_update_goods_price_stockUpdate price and stock of one or more of the seller's goods in one call (mass update). Each entry needs item_rz_id (the Rozetka id, id in…
rozetka_get_goods_countsCount the seller's goods per cabinet section: active, inactive, new, on moderation, waiting for confirmation, waiting for approval…
rozetka_create_goodsCreate a new product listing in the seller's Rozetka cabinet. Needs Russian and Ukrainian name, a category from…
rozetka_list_goods_categoriesSearch the Rozetka categories in which the seller can create goods, by title or ids. Returns id, Ukrainian, Russian and English title…
rozetka_list_category_attributesList the characteristics (attributes) of a Rozetka category, needed for params in rozetka_create_goods. Returns id, titles, unit, type…
rozetka_list_attribute_valuesList the allowed values of one or more characteristics in a category (id, Ukrainian, Russian and English title), for list-type params in…
rozetka_list_producersSearch the Rozetka producer (brand) directory by name or id, for the producer of rozetka_create_goods. Returns id, title and status, 100…
rozetka_list_store_reviewsSearch buyers' reviews of the shop (not of a product): id, order_id, buyer name, comment, overall vote (like, middle, dislike), votes for…
rozetka_reply_store_reviewPublish the seller's public reply to a shop review. Needs the review id and its order_id from rozetka_list_store_reviews. Returns the reply…
rozetka_list_goods_commentsSearch buyers' reviews and questions on the seller's goods: id, type (comment or question), text, mark (rating 1-5), pros and cons, author…
rozetka_reply_goods_commentPost the seller's public answer to a product review or question. parent_id is the comment id and item_id the item.id from…
rozetka_get_message_countsCount unread and total buyer chats and requests: totalUnread, ordersChatUnread, itemsChatUnread, sellerChatUnread, customerRequestsUnread…
rozetka_list_chatsSearch the seller's chats with buyers: order chats, product questions or deleted chats. Returns chat id, subject, buyer (user_id, name)…
rozetka_get_chatOpen one chat with a buyer, with its messages by default. Returns subject, buyer user_id (the receiver_id for rozetka_send_message)…
rozetka_get_order_chatGet the chat that belongs to an order, by order id: chat id, subject, buyer user_id and, with expand, the messages. Use it to write to the…
rozetka_send_messageSend a message to a buyer in an existing chat. Needs chat_id and receiver_id (the buyer's user_id from rozetka_get_chat or…
rozetka_list_refund_requestsSearch buyers' return and refund requests: request id (letters and digits, e.g. AM1234567), status_title, reason_title, order_id, item name…
rozetka_get_refund_requestGet one return or refund request: status, reason and sub-reason with the buyer's comment, decision wanted (decision_title), order and item…
rozetka_list_refund_statusesList the status codes of return and refund requests (status_code with its Ukrainian title), for filtering rozetka_list_refund_requests and…
rozetka_save_refund_ttnSave the waybill (TTN) of the return parcel on a return request, e.g. when the seller sends a replacement or the buyer's return shipment…
rozetka_update_refund_statusMove a return or refund request to another status (accept, reject with a reason, goods received ...). Accepting a request can lead to the…

Example prompts

  • "How many new Rozetka orders and unread buyer messages do I have?"
  • "Show order 123456789 with the buyer, the delivery and the items."
  • "Set the price of goods 987654 to 1,499 UAH and the stock to 20."
  • "Which shop reviews from this week have no reply yet? Draft an answer for each."
  • "Add the Nova Poshta waybill 20450000000000 to order 123456789 and mark it shipped."

FAQ

Which login does it use? Your Rozetka seller cabinet login (seller.rozetka.com.ua), with the password Base64-encoded. The connector signs in again every four hours.

Can it change orders and prices? Yes: order status and waybill (TTN), mass price and stock updates, new goods, replies to reviews, questions and buyer chats. Changing the status of a return request installs switched off, because accepting a return can refund the buyer.

Does it touch balances or payments? No. Balances, invoices, payments, fiscal receipts (PRRO) and paid waybill creation with carriers are not included.

Where is Muse available? Meta currently offers Muse in the US and Canada, on the web, in the iOS and Android apps and in WhatsApp.

Does Meta review this connector? No. Meta doesn't review custom connectors. Muse sees only the tools you switched on for this MCP server in AnythingMCP, and you can disconnect it anytime under Settings → Connectors.

Next steps

Was this guide helpful?

Connect Rozetka Marketplace to Meta Muse in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Rozetka Marketplace in the guided setup, then add your MCP URL to Meta Muse. No code and no server to run.

Related guides

Connectors

Connect Rozetka to Microsoft Copilot via MCP

Rozetka Marketplace seller API for Ukraine's largest marketplace: orders with status and waybill (TTN) updates, payment status, goods with mass price and stock updates and new listings, shop reviews and product questions with replies, buyer chats, and return requests. Signs in with the seller cabinet login.

Connectors

Connect Rozetka to ChatGPT via MCP

Rozetka Marketplace seller API for Ukraine's largest marketplace: orders with status and waybill (TTN) updates, payment status, goods with mass price and stock updates and new listings, shop reviews and product questions with replies, buyer chats, and return requests. Signs in with the seller cabinet login.

Connectors

Connect Rozetka to Claude via MCP

Rozetka Marketplace seller API for Ukraine's largest marketplace: orders with status and waybill (TTN) updates, payment status, goods with mass price and stock updates and new listings, shop reviews and product questions with replies, buyer chats, and return requests. Signs in with the seller cabinet login.

Connectors

Connect Rozetka to Cursor via MCP

Rozetka Marketplace seller API for Ukraine's largest marketplace: orders with status and waybill (TTN) updates, payment status, goods with mass price and stock updates and new listings, shop reviews and product questions with replies, buyer chats, and return requests. Signs in with the seller cabinet login.

Connectors

Connect Rozetka to Gemini CLI via MCP

Rozetka Marketplace seller API for Ukraine's largest marketplace: orders with status and waybill (TTN) updates, payment status, goods with mass price and stock updates and new listings, shop reviews and product questions with replies, buyer chats, and return requests. Signs in with the seller cabinet login.

Connectors

Rozetka MCP Server: Orders, Listings and Stock

Rozetka Marketplace seller API for Ukraine's largest marketplace: orders with status and waybill (TTN) updates, payment status, goods with mass price and stock updates and new listings, shop reviews and product questions with replies, buyer chats, and return requests. Signs in with the seller cabinet login.