Summary
Skroutz Marketplace (Smart Cart) API for sellers on the Greek and Cypriot marketplace: read, accept and schedule orders, Set as Ready, tracking, invoice uploads, returns, Fulfilled by Skroutz stock, purchase orders and suppliers, bulk price and stock updates and CPS orders. API token from the merchants panel.
Guided setup
Connect Skroutz to Cursor in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Skroutz in the guided setup, then add your MCP URL to Cursor. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
Try asking
Example prompts for Skroutz
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 → Skroutz, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Skroutz + Cursor
Skroutz Marketplace (Smart Cart) API for sellers on the Greek and Cypriot marketplace: read, accept and schedule orders, Set as Ready, tracking, invoice uploads, returns, Fulfilled by Skroutz stock, purchase orders and suppliers, bulk price and stock updates and CPS orders. API token from the merchants panel.
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:
SKROUTZ_API_TOKEN
Step 1 — Get credentials
Setting up takes about 3 minutes.
- Sign in to the Skroutz merchants panel and open Services, Skroutz Marketplace (the Smart Cart settings page).
- Generate the API token and paste it into
SKROUTZ_API_TOKEN. A shop has one active token: generating a new one ends the previous one, so a token used by another integration stops working there. - Optional, for bulk price and stock updates: in Products, Feed Updates generate the Products API token and paste it into
SKROUTZ_PRODUCTS_TOKEN. - Optional, for CPS orders of your own web shop: in Παραγγελίες καταστήματος, Αυτόματη διαχείριση (shop orders, automatic handling) generate the CPS token and paste it into
SKROUTZ_CPS_TOKEN.
Every call sends the token as Authorization: Bearer with the media type application/vnd.skroutz+json; version=3.0. The install check reads the demo order DEMO-OPEN, which proves the marketplace token without touching real data.
Where to start: the API has no order list. Orders reach a shop through the order webhook, the merchants panel and the order emails, so ask the user for the order code (like 191128-1234567) and read it with skroutz_get_order. The demo codes DEMO-OPEN, DEMO-ACCEPTED, DEMO-REJECTED, DEMO-INVOICE, DEMO-FBS, DEMO-STORE-PICKUP and DEMO-RETURN are safe to read, accept and reject for testing: nothing is stored.
Orders: an open order carries accept_options and reject_options and must be handled before expires_at. Accept it with skroutz_accept_order, sending a pickup location id and the id of one of that location's own pickup windows (windows differ per location). Skroutz then books the courier and the voucher PDF appears in courier_voucher. Express orders are accepted by Skroutz automatically. skroutz_reject_order is installed switched off: a rejection cannot be undone and counts against the shop. To change the pickup of an accepted order, read it with action_options 1 right before and use skroutz_reschedule_order_pickup (a date from reschedule_options) or skroutz_relocate_order_pickup (an id from relocate_options); the lists shrink over time. skroutz_request_preorder_voucher creates the voucher of an accepted preorder early.
Set as Ready: when an order shows set_as_ready_required true, Skroutz Last Mile only picks it up after skroutz_set_order_ready; downloading the voucher no longer marks it ready (since 30 March 2026). Marking early can move the pickup to an earlier window. skroutz_set_order_not_ready undoes it before pickup. Shops with set_as_ready_required false need neither.
Shipping and documents: skroutz_update_tracking_details sends courier and tracking code for Fulfilled by Merchant (FBM) orders only. skroutz_upload_invoice and skroutz_upload_credit_invoice take a public link to the PDF, PNG or JPG (at most 7 MB); the connector downloads it and uploads the file, one per order, replacing an earlier upload.
Returns: skroutz_get_return reads a return by its code (like R-111111-1111111, from the return webhook or the merchants panel; the returns of an order give only a uuid and tracking ids). skroutz_handle_return (decide a return waiting for review before review.expires_at, including sending a missing part at the shop's cost) and skroutz_submit_service_inspection (technical report on a faulty item, as a file link) are installed switched off, because they lead to refunds, replacements or paid shipments. skroutz_file_compensation_request is switched off too: it claims money from Skroutz for returned items, and through this connector only for the reasons that need no photos.
Fulfilled by Skroutz: skroutz_list_fbs_products (stock in Skroutz warehouses), skroutz_list_fbs_purchase_orders, skroutz_list_fbs_purchase_order_items, skroutz_list_fbs_suppliers, skroutz_create_fbs_supplier and skroutz_update_fbs_supplier. skroutz_create_fbs_purchase_order is switched off, because warehouse fees follow from it. Lists are paged with page and come with meta.pagination (100 rows a page). A shop without FBS gets 401 here.
Products API (needs SKROUTZ_PRODUCTS_TOKEN): skroutz_validate_product_updates checks a batch without changing anything; skroutz_update_products (switched off) updates availability, price and quantity of up to 500 existing products and variations, asynchronously; skroutz_get_product_update_status reports success, no_change or failure per product. Prices here are integer euro cents (1050 is 10.50 EUR), while order amounts are decimal euros. It does not create products: those come from the XML feed. A 422 saying the XML is being scanned means try again later.
CPS orders (needs SKROUTZ_CPS_TOKEN): skroutz_get_cps_order reads a sale of your own web shop by your own order number, with revenue and commission; skroutz_reject_cps_order (switched off) rejects it so no commission is charged.
Field notes: times are ISO 8601 with the Athens offset (+02:00 in winter, +03:00 in summer). Labels such as pickup windows, rejection reasons and CPS states come in Greek. Line item ids are short strings (l39vKqxqwe); shop_uid is your own product id. Errors carry an errors array with a code and messages: 422 order_status means the order is not in a state for that action. A wrong or replaced marketplace token answers 403. The connector never moves money: rejections, return decisions, compensation claims, purchase orders and bulk product updates are installed switched off for an admin to turn on deliberately.
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 showsYOUR_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" }
}
}
}
- Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of
YOUR_MCP_API_KEY. - Save the file and restart Cursor.
- Open Cursor → Settings → MCP and check that
anythingmcpis listed and connected. - Start chatting — the agent can now call the
Skroutztools.
Available tools
| Tool | What it does |
|---|---|
skroutz_get_order | Read one Skroutz Marketplace (Smart Cart) order by its code: state (open, accepted, rejected, cancelled, expired, dispatched, delivered… |
skroutz_accept_order | Accept an open order: Skroutz then books the courier and issues the voucher (it arrives on the order as courier_voucher). Send a… |
skroutz_reject_order | Reject an open order, either per line item with a reason id from reject_options (with available_quantity when the reason has… |
skroutz_reschedule_order_pickup | Move the courier pickup of an accepted order to another date. Read the order with action_options 1 right before and send one of its… |
skroutz_relocate_order_pickup | Move the courier pickup of an accepted order to another of the shop's pickup locations, keeping the pickup date and slot. The courier is… |
skroutz_set_order_ready | Mark an accepted order as packed and ready for dispatch (Set as Ready). Required for shops whose orders show set_as_ready_required true… |
skroutz_set_order_not_ready | Undo Set as Ready on an accepted order that the courier has not picked up yet. Skroutz tries to move the pickup back to the original date.… |
skroutz_update_tracking_details | Send the courier and tracking code of each shipment of a Fulfilled by Merchant (FBM) order, so the customer can follow it. Only for FBM… |
skroutz_request_preorder_voucher | Ask for the courier voucher of an accepted preorder now, when the product arrived before the planned shipment date (the panel's Create… |
skroutz_upload_invoice | Upload the receipt or invoice of an order from a link to the file (PDF, PNG or JPG, at most 7 MB). One file per order: a new upload… |
skroutz_upload_credit_invoice | Upload the credit invoice of an order that was cancelled, returned, partially returned or returned to sender after its receipt or invoice… |
skroutz_file_compensation_request | Ask Skroutz to compensate the shop for returned line items, sent as JSON without photos, so only for reasons that need none… |
skroutz_get_return | Read one return by its code: state (pending_merchant_review, returning, pending_physical_review, pending_service_inspection, returned… |
skroutz_handle_return | Decide a return in state pending_merchant_review with one of its handle_options: approve, a rejection such as not_faulty (with comment when… |
skroutz_submit_service_inspection | Submit the technical inspection result of a faulty returned item (return in state pending_service_inspection): the item id, one of its… |
skroutz_list_fbs_products | List the shop's Fulfilled by Skroutz (FBS) products stored in Skroutz warehouses: id, shop_uid (your product id), active (buyable from the… |
skroutz_list_fbs_purchase_orders | List the shop's Fulfilled by Skroutz purchase orders (stock sent to Skroutz warehouses): code, created_at, expected_date and received_at.… |
skroutz_list_fbs_purchase_order_items | List the line items of one Fulfilled by Skroutz purchase order: product_id, shop_uid, active, expected_quantity and actual_quantity… |
skroutz_create_fbs_purchase_order | Announce a new Fulfilled by Skroutz purchase order: the stock you will deliver to a Skroutz warehouse, with the expected date, the supplier… |
skroutz_list_fbs_suppliers | List the shop's Fulfilled by Skroutz suppliers: id (use it for purchase orders), code, name, address, city, area, zip_code, phone… |
skroutz_create_fbs_supplier | Add a Fulfilled by Skroutz supplier (who ships stock to the Skroutz warehouse for you) with a unique code, name, address, city, area, zip… |
skroutz_update_fbs_supplier | Change fields of a Fulfilled by Skroutz supplier; only the fields you send change. Answers success: true |
skroutz_validate_product_updates | Check a batch of product updates (availability, price in cents, quantity, variations) without changing anything: Skroutz runs every check… |
skroutz_update_products | Update availability, price (euro cents) and quantity of up to 500 existing products and their variations in one batch; it does not create… |
skroutz_get_product_update_status | Read the outcome of a product batch update: status (in_progress while any product is pending, then completed), created_at, and per product… |
skroutz_get_cps_order | Read one CPS order (a sale on your own web shop that came from Skroutz, paid by commission) by the order code your shop gave it: date… |
skroutz_reject_cps_order | Reject a CPS order so Skroutz does not charge commission on it, with one of its reject_options (user_cancel, user_return, undelivered… |
Example prompts
- "Show order 251114-3920517 with its items, its pickup options and when it expires."
- "Accept order 251114-3920517 for the first pickup window of my Athens warehouse."
- "Order 251112-1187340 needs Set as Ready: is it ready to mark, and when is the pickup?"
- "What does return R-251110-2045318 say, and by when do I have to review it?"
- "How many units of each product do I have in the Skroutz warehouses?"
FAQ
Where do the tokens come from? From the Skroutz merchants panel, and they are three separate tokens: the marketplace API token under Services, Skroutz Marketplace (orders, returns, Fulfilled by Skroutz), the optional Products API token under Products, Feed Updates for bulk price and stock updates, and the optional CPS token for orders of your own web shop. Generating a new marketplace token ends the old one.
Can it list my orders? No. The Skroutz API has no order list: orders reach a shop through the webhook, the merchants panel and the order emails. Give the AI the order code (like 251114-3920517) and it reads the order. Demo codes such as DEMO-OPEN are safe for testing.
Which tools install switched off? skroutz_reject_order and skroutz_reject_cps_order, because a rejection cannot be undone, the return tools skroutz_handle_return, skroutz_submit_service_inspection and skroutz_file_compensation_request, skroutz_create_fbs_purchase_order, which leads to warehouse fees, and skroutz_update_products.
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?