Connect Back Market to Gemini CLI via MCP

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Back Market, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Back Market + Gemini

Back Market seller API for refurbishers: orders with accept and ship with tracking, listings with price and stock, Backbox and competitor prices, categories, customer care folders and messages, BackShip deliveries and BuyBack orders. API token, per platform (Europe, United States, Asia-Pacific).

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:

BACK_MARKET_HOST, BACK_MARKET_TOKEN, BACK_MARKET_MARKET

Step 1 — Get credentials

Setting up takes about 3 minutes.

1. Sign in to the Back Market back office of your platform: https://www.backmarket.fr/bo-seller (Europe), https://www.backmarket.com/bo-seller (United States) or https://www.backmarket.co.jp/bo-seller (Japan and Australia). API access comes with a seller account Back Market has validated.
2. Open the Integrations page under Options and create an API token.
3. Paste the token as shown into BACK_MARKET_TOKEN, without the word Basic in front: the connector sends it as Authorization: Basic followed by the token.
4. Choose your platform in BACK_MARKET_HOST and your main market in BACK_MARKET_MARKET (for example fr-fr on Europe, en-us on the United States, ja-jp on Asia-Pacific). The market must belong to the platform.

Every call carries the market in Accept-Language and the User-Agent BM-AnythingMCP-Connector, which Back Market requires. Tools with a market argument can look at another market of the same platform for one call.

Where to start: back_market_list_orders with state 1 shows paid orders whose lines you must accept, state 3 the orders to ship. back_market_list_listings shows your offers; back_market_list_backbox tells which of them hold the Backbox.

Order workflow: an order arrives in state 1 once payment is validated (never ship states 0, 8 or 10). Accept each line with back_market_accept_order_line (line state 1 to 2); the order then moves to state 3. Ship with back_market_ship_order and a tracking number (all lines go in one parcel, order state 9). back_market_get_order shows the line states. back_market_set_order_line_identifiers stores the IMEI or serial number of the device; it cannot be corrected afterwards. back_market_cancel_order_line and back_market_refund_order_line are installed switched off: both refund the customer and cannot be undone, and cancellations weigh on the Backbox.

Listings: one listing covers all markets of the platform. Quantity is shared; price, comment and warranty are per market. back_market_get_listing finds a listing by SKU; back_market_update_listing changes price or stock in real time (quantity 0 takes it offline). back_market_import_listings (switched off) sends a CSV for many listings at once and answers a task id for back_market_get_task. back_market_get_competitors shows the price needed to win the Backbox per market. back_market_get_category_tree and back_market_get_category_branch give the categories and the attributes a new product needs.

Customer care: back_market_list_care_folders and back_market_get_care_folder read after-sales cases with their messages; back_market_send_care_message answers the customer. back_market_create_care_refund is installed switched off.

BackShip and BuyBack: back_market_list_deliveries and back_market_list_returns only return data for sellers who use Back Market's BackShip labels. back_market_list_buyback_orders and back_market_get_buyback_order read trade-in orders; validating or countering one decides what the customer is paid and is not included.

Formats: prices are decimal strings with tax, in the currency of the market (160.99). Order ids and order line ids are integers; listing ids are UUIDs (the numeric listing_id is deprecated). Dates are RFC 3339; the care folder filters use YYYY-MM-DD-hh-mm. Lists answer count, next, previous and results; next is null on the last page.

Limits: more than 200 calls in 10 seconds are blocked for 10 seconds (catalogue calls: 20 in 10 seconds), with a 429. Listing updates are limited to about 2,000 SKU lines per hour. Care calls have daily limits (folder list 4,000 a day, refunds 500 a day).

403 answers: Back Market sits behind Cloudflare. A 403 with an HTML page or the code bot-need-challenge means the firewall blocked the caller, not that the token is wrong: send the cf-ray value of the answer to your Back Market contact. A wrong or missing token also answers 403 or 401, with a JSON error.

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 Back Market tools.

Available tools

Example prompts

• "Which Back Market orders have lines waiting for my acceptance?"
• "Which of my listings lost the Backbox, and what price would win it back?"
• "Set the stock of my refurbished iPhone 13 128 GB listing to 12."
• "Ship order 41234567 with Colissimo tracking 6A12345678901 and the IMEI of each line."
• "Which customer care folders are open, and what do the customers ask?"

FAQ

Where do I get the API token? In the Back Market back office of your platform, Options, Integrations. Paste the token as shown, without the word Basic, and choose your platform (Europe, United States or Asia-Pacific) and main market. API access comes with a seller account Back Market has validated.

Which markets does it cover? Every market of the platform your account is on: the European markets on backmarket.fr, the United States on backmarket.com, and Japan and Australia on backmarket.co.jp. Tools with a market argument can look at another market of the same platform.

Which tools install switched off? back_market_cancel_order_line, back_market_refund_order_line, back_market_create_care_refund and back_market_import_listings, because they refund customers or replace listings in bulk. Switch them on on the connector page only if the AI should use them.

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

• Connector landing page
• Connect to Claude