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 Cursor in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Spartoo Marketplace 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 Spartoo Marketplace
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 → Spartoo Marketplace, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Spartoo Marketplace + Cursor
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.
- Sign in to the Spartoo marketplace back office and open Documentation, then Webservices and any service page, e.g. Exporting orders.
- The line Webservice URL names the web service address of your Spartoo site, e.g.
https://sws.spartoo.euorhttps://sws.spartoo.it. Put the part before/mp/intoSPARTOO_HOST. - On the same page the row
partnershows your unique code when you are signed in. Put it intoSPARTOO_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:sswith 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_priceis the discounted unit price times the quantity. - An order for a pickup point has
relay_infoinstead 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 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
Spartoo Marketplacetools.
Available tools
| Tool | What it does |
|---|---|
spartoo_list_orders | List the orders placed since a date, optionally only those in one status. Per order under root.orders.order: orders_id, customers… |
spartoo_get_order | Read 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_order | Accept 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_order | Mark 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_order | Cancel 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_returns | List the returns registered since a moment, optionally only those in one status. Per return under root.returns.return: return_id… |
spartoo_get_return | Read 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_status | Check 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_stock | Set 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.
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?