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 Microsoft Copilot in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Spartoo Marketplace in the guided setup, then add your MCP URL to Microsoft Copilot. 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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot uses MCP servers through agents built in Copilot Studio: you add AnythingMCP to an agent as a tool, then publish the agent to Microsoft 365 Copilot and Teams. Copilot Studio connects from Microsoft's cloud over Streamable HTTP, which AnythingMCP supports.
- In Copilot Studio, open your agent (or create one), go to Tools and choose Add a tool → New tool → Model Context Protocol.
- Enter a Server name (for example
AnythingMCP), a Server description that says what the connector does, and the Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio uses the description to decide when to call the server. - Under authentication, choose API key, set Type to Header and the header name to
X-API-Key, then select Create. - In Add tool, choose Create a new connection, paste an MCP API key from AnythingMCP (MCP Servers → your server → API keys) and select Add to agent.
- Try it in the agent's Test pane: ask for something that needs the
Spartoo Marketplacetools. - Select Publish, then Channels → Microsoft 365 and Microsoft Teams, keep Make agent available in Microsoft Copilot selected and choose Add channel. See agent in Teams installs it for you; in Microsoft 365 Copilot, type @ and pick the agent.
Prefer per-user sign-in? Choose OAuth 2.0 → Dynamic discovery instead of an API key: each user then signs in to AnythingMCP the first time the agent calls it.
Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Copilot Studio connects from Microsoft's cloud, so localhost does not work.
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.
Which Copilot is this for? Microsoft 365 Copilot at work, through agents built in Copilot Studio. The Microsoft Copilot app for personal accounts has no option to add your own MCP server.
What do I need? A work account with access to Copilot Studio (a license or a trial) to build the agent. People who use it in Microsoft 365 Copilot or Teams need access to the agent: share it with them, or ask an admin to publish it to the organization. If your organization applies data policies to Power Platform connectors, they cover MCP servers too.
The agent doesn't call the tools. Check that the header name is exactly X-API-Key and that the key belongs to the same MCP server as the URL, and make the server description specific: Copilot Studio uses it to decide when to call the server. Publish the agent again after each change; in an open chat, type "start over" to get the new version.
Next steps
Was this guide helpful?