Connector guide6-minute read9 MCP tools7 languages

Connect Spartoo Marketplace to Gemini CLI via MCP

Spartoo marketplace web services for sellers: orders with customer and delivery details, accepting and shipping orders with a tracking number, returns, the status of a product on the site and stock updates per size. Partner code as a form field, XML answers read as JSON.

HCBy HelpCode teamUpdated 6 min read Open-source on GitHub

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

Spartoo Marketplace

Spartoo Marketplace

Spartoo marketplace web services for sellers: orders with customer and delivery details, accepting and shipping orders with a tracking number, returns, the status of a product on the site and stock updates per size. Partner code as a form field, XML answers read as JSON.

tools

9

Region

INTL

Category

E-commerce

Authentication

API credentials

Required env vars

SPARTOO_HOSTSPARTOO_PARTNER_KEY
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

Spartoo marketplace web services for sellers: orders with customer and delivery details, accepting and shipping orders with a tracking number, returns, the status of a product on the site and stock updates per size. Partner code as a form field, XML answers read as JSON.

Guided setup

Connect Spartoo Marketplace to Gemini in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Spartoo Marketplace 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 Spartoo Marketplace

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

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

Spartoo Marketplace + Gemini

Spartoo marketplace web services for sellers: orders with customer and delivery details, accepting and shipping orders with a tracking number, returns, the status of a product on the site and stock updates per size. Partner code as a form field, XML answers read as JSON.

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:

SPARTOO_HOST, SPARTOO_PARTNER_KEY

Step 1 — Get credentials

Setting up takes about 3 minutes.

  1. Sign in to the Spartoo marketplace back office and open Documentation, then Webservices and any service page, e.g. Exporting orders.
  2. The line Webservice URL names the web service address of your Spartoo site, e.g. https://sws.spartoo.eu or https://sws.spartoo.it. Put the part before /mp/ into SPARTOO_HOST.
  3. On the same page the row partner shows your unique code when you are signed in. Put it into SPARTOO_PARTNER_KEY. If the page shows no code, ask your Spartoo marketplace contact for the web service code of your account.

Where to start: spartoo_list_orders with a start date. spartoo_get_order reads one order by its id.

Orders: an order arrives in status 11 (verified). spartoo_accept_order moves it to 2 (in preparation): after that its name, address and carrier can no longer change. spartoo_ship_order moves it from 2 to 3 (shipped) with the carrier's tracking number, and Spartoo emails the tracking link to the customer. spartoo_cancel_order (status 41) is installed switched off: the customer is refunded and it cannot be undone. Statuses 45 (parcel lost) and 47 (parcel not delivered) are set by Spartoo.

Returns: spartoo_list_returns and spartoo_get_return. One return holds one product. Return statuses: 2 waiting to be received, 3 refused, 4 parcel received and return accepted, 5 paid, 7 refund, 14 waiting for the merchant's prepaid return label. This connector does not accept or refuse returns.

Products and stock: spartoo_check_product_status says whether a product is on the site (OK), out of stock (OS), created but not yet online (EC) or unknown (KO), with the reason. spartoo_update_stock sets the stock of one size. Both use your own references: reference_partenaire is the product in one colour, size_reference one size of it. Stock 0 takes the size off the site.

Field notes

  • Order ids and return ids are short codes such as 90D813EA1A2365A8.
  • The order date filter is written YYYY-MM-DD:hh:mm:ss with a colon between day and hour. The return date filter is a Unix timestamp in seconds. Spartoo does not document the time zone.
  • Prices are decimal numbers in the currency of the order's site; products_final_price is the discounted unit price times the quantity.
  • An order for a pickup point has relay_info instead of the delivery address.
  • Text values arrive as strings, numbers included. One order or product in a list arrives as an object, several as an array.

Errors: every answer carries a code. 1 means no error. -1 and -2: the partner code is missing or unknown. -3: date or id missing. -4: wrong date format. -6 and -28: order or return not found. -8: tracking number refused. -9: the order already has that status. -19: wrong order of statuses (2 only from 11, 3 only from 2). -14: product not found. -16, -18 and -20: stock not changed (not possible, already that value, or the size is no longer valid). -30: order too old to ship, contact Spartoo. -428: account deactivated. -429: too many requests in one hour. The connector reports a negative code as a failed call.

Not covered: creating and editing products, prices and discounts (they go through an XML catalogue file), packing slips, and return decisions.

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 Spartoo Marketplace tools.

Available tools

ToolWhat it does
spartoo_list_ordersList the orders placed since a date, optionally only those in one status. Per order under root.orders.order: orders_id, customers…
spartoo_get_orderRead one order by its id: customer and delivery details (or the pickup point in relay_info), payment method, shipping name and price, order…
spartoo_accept_orderAccept a new order: moves it from status 11 (verified) to 2 (in preparation). After that the order's name, delivery address and carrier can…
spartoo_ship_orderMark an accepted order as shipped with the carrier's tracking number: moves it from status 2 to 3, and Spartoo emails the tracking link to…
spartoo_cancel_orderCancel an order that has not shipped (status 41). The customer does not receive the order and is refunded by Spartoo; it cannot be undone…
spartoo_list_returnsList the returns registered since a moment, optionally only those in one status. Per return under root.returns.return: return_id…
spartoo_get_returnRead the returns of one order, or one return by its id: return id and date, status id and name, reason, order id and the returned product…
spartoo_check_product_statusCheck whether one of your products is on the Spartoo site. Returns under root.products.product your reference, a status (OK on the site…
spartoo_update_stockSet the stock of one size of one product, in real time. Stock 0 takes that size off the site; a product whose sizes are all 0 goes offline.…

Example prompts

  • "Which Spartoo orders came in since Monday and still need to be accepted?"
  • "Accept order 90D813EA1A2365A8 and ship it with Royal Mail tracking AB123456789GB."
  • "Which returns are waiting to be received?"
  • "Is my product REF-BOOT-221 online, and if not, why?"
  • "Set the stock of size 38 of REF-BOOT-221 to 6."

FAQ

Where does the partner code come from? In the Spartoo marketplace back office, Documentation, Webservices, any service page: the row partner shows your code and the line Webservice URL names your site's address. If no code is shown, ask your Spartoo marketplace contact.

What does it cover, and what not? Orders with customer and delivery details, accepting and shipping with a tracking number, returns, product status and stock per size. It does not accept or refuse returns. To search the Spartoo catalogue as a shopper, use the Spartoo Shop connector.

Which tools install switched off? spartoo_cancel_order, because a cancellation refunds the customer and cannot be undone. Switch it on on the connector page only if the AI should use it.

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

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

Related guides

Connectors

Connect Spartoo Marketplace to ChatGPT via MCP

Spartoo marketplace web services for sellers: orders with customer and delivery details, accepting and shipping orders with a tracking number, returns, the status of a product on the site and stock updates per size. Partner code as a form field, XML answers read as JSON.

Connectors

Connect Spartoo Marketplace to Claude via MCP

Spartoo marketplace web services for sellers: orders with customer and delivery details, accepting and shipping orders with a tracking number, returns, the status of a product on the site and stock updates per size. Partner code as a form field, XML answers read as JSON.

Connectors

Connect Spartoo Marketplace to Microsoft Copilot via MCP

Spartoo marketplace web services for sellers: orders with customer and delivery details, accepting and shipping orders with a tracking number, returns, the status of a product on the site and stock updates per size. Partner code as a form field, XML answers read as JSON.

Connectors

Connect Spartoo Marketplace to Cursor via MCP

Spartoo marketplace web services for sellers: orders with customer and delivery details, accepting and shipping orders with a tracking number, returns, the status of a product on the site and stock updates per size. Partner code as a form field, XML answers read as JSON.

Connectors

Connect Spartoo Marketplace to Meta Muse via MCP

Spartoo marketplace web services for sellers: orders with customer and delivery details, accepting and shipping orders with a tracking number, returns, the status of a product on the site and stock updates per size. Partner code as a form field, XML answers read as JSON.

Connectors

Spartoo Marketplace MCP Server: Orders and Stock

Spartoo marketplace web services for sellers: orders with customer and delivery details, accepting and shipping orders with a tracking number, returns, the status of a product on the site and stock updates per size. Partner code as a form field, XML answers read as JSON.