Connector guide10-minute read27 MCP tools7 languages

Connect Skroutz to Gemini CLI via MCP: Orders and Stock

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.

HCBy HelpCode teamUpdated 10 min read Open-source on GitHub

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

Skroutz

Skroutz

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.

tools

27

Region

INTL

Category

E-commerce

Authentication

API credentials

Required env vars

SKROUTZ_API_TOKEN
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

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 Gemini in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Skroutz in the guided setup, then add your MCP URL to Gemini. 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.

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

Skroutz + Gemini

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.

  1. Sign in to the Skroutz merchants panel and open Services, Skroutz Marketplace (the Smart Cart settings page).
  2. 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.
  3. Optional, for bulk price and stock updates: in Products, Feed Updates generate the Products API token and paste it into SKROUTZ_PRODUCTS_TOKEN.
  4. 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 Gemini

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.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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 gemini.
  3. Run /mcp inside Gemini CLI (or gemini mcp list in your shell) — anythingmcp should show as connected.
  4. Start prompting — Gemini CLI can now call the Skroutz tools.

Available tools

ToolWhat it does
skroutz_get_orderRead one Skroutz Marketplace (Smart Cart) order by its code: state (open, accepted, rejected, cancelled, expired, dispatched, delivered…
skroutz_accept_orderAccept an open order: Skroutz then books the courier and issues the voucher (it arrives on the order as courier_voucher). Send a…
skroutz_reject_orderReject an open order, either per line item with a reason id from reject_options (with available_quantity when the reason has…
skroutz_reschedule_order_pickupMove 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_pickupMove 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_readyMark 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_readyUndo 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_detailsSend 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_voucherAsk for the courier voucher of an accepted preorder now, when the product arrived before the planned shipment date (the panel's Create…
skroutz_upload_invoiceUpload 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_invoiceUpload the credit invoice of an order that was cancelled, returned, partially returned or returned to sender after its receipt or invoice…
skroutz_file_compensation_requestAsk Skroutz to compensate the shop for returned line items, sent as JSON without photos, so only for reasons that need none…
skroutz_get_returnRead one return by its code: state (pending_merchant_review, returning, pending_physical_review, pending_service_inspection, returned…
skroutz_handle_returnDecide 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_inspectionSubmit the technical inspection result of a faulty returned item (return in state pending_service_inspection): the item id, one of its…
skroutz_list_fbs_productsList 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_ordersList 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_itemsList the line items of one Fulfilled by Skroutz purchase order: product_id, shop_uid, active, expected_quantity and actual_quantity…
skroutz_create_fbs_purchase_orderAnnounce 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_suppliersList the shop's Fulfilled by Skroutz suppliers: id (use it for purchase orders), code, name, address, city, area, zip_code, phone…
skroutz_create_fbs_supplierAdd 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_supplierChange fields of a Fulfilled by Skroutz supplier; only the fields you send change. Answers success: true
skroutz_validate_product_updatesCheck a batch of product updates (availability, price in cents, quantity, variations) without changing anything: Skroutz runs every check…
skroutz_update_productsUpdate 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_statusRead 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_orderRead 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_orderReject 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.

Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.

Next steps

Was this guide helpful?

Connect Skroutz to Gemini in 2 minutes

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

Related guides

Connectors

Connect Skroutz to ChatGPT via MCP: Orders and Stock

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.

Connectors

Connect Skroutz to Claude via MCP: Orders and Stock

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.

Connectors

Connect Skroutz to Microsoft Copilot via MCP

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.

Connectors

Connect Skroutz to Cursor via MCP: Orders and Stock

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.

Connectors

Connect Skroutz to Meta Muse via MCP: Orders and Stock

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.

Connectors

Skroutz MCP Server: Orders, Stock and Returns

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.