Connector guide10-minute read33 MCP tools7 languages

Connect refurbed to Gemini CLI via MCP

refurbed Seller API for sellers of refurbished electronics: orders and order items (accept, ship with tracking and IMEI), refund dry runs, shipping labels, invoices, returns, support tickets, offers with stock and prices, market prices, product lookup, shipping profiles and carriers. API token from refurbed.

HCBy HelpCode teamUpdated 10 min read Open-source on GitHub

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

refurbed

refurbed

refurbed Seller API for sellers of refurbished electronics: orders and order items (accept, ship with tracking and IMEI), refund dry runs, shipping labels, invoices, returns, support tickets, offers with stock and prices, market prices, product lookup, shipping profiles and carriers. API token from refurbed.

tools

33

Region

INTL

Category

E-commerce

Authentication

API Key

Required env vars

REFURBED_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

refurbed Seller API for sellers of refurbished electronics: orders and order items (accept, ship with tracking and IMEI), refund dry runs, shipping labels, invoices, returns, support tickets, offers with stock and prices, market prices, product lookup, shipping profiles and carriers. API token from refurbed.

Guided setup

Connect refurbed to Gemini in 2 minutes

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

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

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

refurbed + Gemini

refurbed Seller API for sellers of refurbished electronics: orders and order items (accept, ship with tracking and IMEI), refund dry runs, shipping labels, invoices, returns, support tickets, offers with stock and prices, market prices, product lookup, shipping profiles and carriers. API token from refurbed.

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:

REFURBED_API_TOKEN

Step 1 — Get credentials

Setting up takes about 5 minutes. You need the plus refurbed's answer.

  1. Request an API token with the form at supplier.refurbed.com/api-token-request (or ask your account manager or [email protected]). refurbed sends a token that looks like a UUID.
  2. Paste it into REFURBED_API_TOKEN, install and run refurbed_list_orders. The connector sends it as Authorization: Plain followed by the token.
  3. A token that is not used for 2 months expires; then request a new one. Some calls must also be enabled by refurbed for your account (shipping labels, new-battery offers).

The API runs on https://api.refurbed.com. refurbed also gives each seller a sandbox on request (supplier.refurbed.com/sandbox-request), at an address like https://grpc-<name>.qa.refurbed.io, with test orders; a self-hosted installation can point a copy of this connector there.

Where to start: refurbed_list_orders with states NEW shows orders to handle; refurbed_get_order and refurbed_list_order_items show the items. Accept with refurbed_accept_order_item, then ship with refurbed_ship_order_item (tracking link, or carrier slug from refurbed_list_available_carriers plus tracking number, and the IMEI or serial in item_identifiers). refurbed_batch_update_order_item_states does up to 50 at once; refurbed_update_order_item changes tracking, identifiers, notes or Swiss customs data later; refurbed_get_order_item reads one item.

Order item states: NEW goes to ACCEPTED, REJECTED or CANCELLED; ACCEPTED goes to SHIPPED or CANCELLED; SHIPPED can become RETURNED. Skipping a step fails with code 9 (cannot change state from new to shipped). REJECTED and CANCELLED are final and do not refund: refurbed_reject_order_item is installed switched off, and refurbed expects you to tell the customer through a ticket first. The order state is calculated from its items. Do not use the deprecated fields parcel_tracking_number, parcel_tracking_carrier and the single item_identifier.

Refunds: this connector never refunds. refurbed_calculate_item_refund and refurbed_calculate_order_refund are dry runs that show the amounts; the refund itself is done in the seller interface (it needs an open ticket).

Labels, invoices, returns, tickets: refurbed_list_shipping_labels gives fresh label links; refurbed_create_shipping_label (switched off) creates a real label on refurbed's shipping agreement with each call. refurbed_get_order_invoice links the invoice you uploaded. refurbed_list_returns lists returns with refurbed return labels; set the item to RETURNED when the parcel arrives. refurbed_list_tickets and refurbed_get_ticket read customer tickets.

Offers: refurbed_list_offers, refurbed_get_offer, refurbed_create_offer (find the product with refurbed_get_instance, the profile with refurbed_list_shipping_profiles), refurbed_update_offer and refurbed_batch_update_offers for stock and prices. Identify offers by SKU: offer ids change when an offer is recreated. Pause with stock 0; refurbed_delete_offer is switched off. Fixed prices per market: refurbed_list_market_offers, refurbed_create_market_offer, refurbed_update_market_offer, refurbed_delete_market_offer (switched off); only site markets of refurbed_list_markets take them. Only warranty M12 is accepted for new offers; grading is AA, A, B or C.

Other lookups: refurbed_list_merchant_addresses (sender address ids for labels) and refurbed_get_currency (exchange rates; the setup check uses it).

How the API works: every call is a POST of a JSON body to /refb.merchant.v1.<Service>/<Method>. Field names are snake_case; ids are whole numbers sent and returned as strings ("3496079"); money is a decimal string with a dot ("199.99", a comma is refused); times are RFC 3339 in UTC; enums are sent by name. Give an offer by sku or by id, never both. Lists page with a cursor: pass the last id as starting_after while has_more is true, up to 100 rows. Batches take 1 to 50 items and answer one status per item.

Limits and errors: 10 requests per second by default (headers X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset); over it you get 429 RESOURCE_EXHAUSTED. Errors answer code and message with gRPC codes: 3 invalid argument, 5 not found, 6 already exists, 7 permission denied, 9 failed precondition, 16 unauthenticated.

Terms: refurbed's API terms allow integrators acting for sellers, but each action must be traceable to the seller, and API data may not be resold or used for benchmarking or market intelligence.

Writes: confirm first. Accepting, shipping, tracking, stock and price changes act on the live account. Before each call show the user what changes and wait for a yes.

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 refurbed tools.

Available tools

ToolWhat it does
refurbed_list_ordersList orders, newest first by default: id, released_at, state (NEW, ACCEPTED, SHIPPED, FULFILLED, CANCELLED and others), labels (e.g.…
refurbed_get_orderRead one order with all its items: state, labels, customer email, shipping and invoice address (with VAT numbers), totals and settlement…
refurbed_list_order_itemsList the items of one order: id, name, state, sku, totals, commission, taxation, offer data (offer id, grading, warranty, shipping…
refurbed_get_order_itemRead one order item by its own id (not the order id): state, sku, prices and commission, offer data, tracking link and carrier…
refurbed_accept_order_itemAccept a NEW order item (state ACCEPTED): you confirm you will ship it. Answers the updated item
refurbed_ship_order_itemMark an ACCEPTED order item as SHIPPED with its tracking: a full parcel_tracking_url, or parcel_carrier_tracking_number (carrier slug and…
refurbed_update_order_itemChange an order item without changing its state: replace the tracking link or carrier tracking number, add identifiers (IMEI, serial)…
refurbed_batch_update_order_item_statesChange the state of up to 50 order items in one call (accept or ship several). Each update has the fields of the single calls; the answer…
refurbed_reject_order_itemReject (NEW item) or cancel (NEW or ACCEPTED item) an order item. Final and cannot be undone; it does not refund the customer by itself…
refurbed_calculate_item_refundDry run: show what refunding an order item would mean (total_paid, total_refunded, refunded, the refurbed and merchant shares) without…
refurbed_calculate_order_refundDry run: show what refunding all refundable items of an order would come to, without refunding anything
refurbed_list_shipping_labelsList the shipping labels created for an order: id, printer PDF links (they expire after about an hour, call again for fresh ones), tracking…
refurbed_create_shipping_labelCreate a shipping label for an order on refurbed's shipping agreement (DHL Express today). Every call creates a new real label and its…
refurbed_get_order_invoiceGet a download link (valid 24 hours) for the invoice you uploaded for an order. NOT_FOUND when there is none
refurbed_list_returnsList returns that run on refurbed return labels: id, order_id, order_item_id, instance_name, identifiers, state (INITIATED, IN_TRANSIT…
refurbed_list_ticketsList customer support tickets: id, status (OPEN, PENDING, SOLVED, CLOSED), topic, urgency, customer, order and order item…
refurbed_get_ticketRead one support ticket with its messages, topic, status, order references and notes
refurbed_list_offersList your offers: id, sku, instance_id and instance_name, state (OK, UNVERIFIED, PENDING_REVIEW, REJECTED with rejection_reason), grading…
refurbed_get_offerRead one offer by SKU or by id: state, grading, warranty, stock, shipping profiles, taxation, reference prices and the market prices with…
refurbed_create_offerCreate an offer for a product: instance_id (refurbed_get_instance), or a gtin or mpn (the offer is then UNVERIFIED until refurbed checks…
refurbed_update_offerChange an offer by SKU or id: stock, reference price and min price, grading, warranty, shipping profile or taxation; only the fields given…
refurbed_batch_update_offersChange up to 50 offers in one call (stock and price updates). Each entry has identifier plus the fields of refurbed_update_offer; the…
refurbed_delete_offerDelete an offer by SKU or id. Cannot be undone; to pause an offer set stock 0 with refurbed_update_offer instead. Installed switched off
refurbed_list_market_offersList the per-market prices of one offer: market_code, whether it is a site market, set or calculated price and min price, currency…
refurbed_create_market_offerSet a fixed price for an offer in one site market instead of the price calculated from the reference price. ALREADY_EXISTS when the market…
refurbed_update_market_offerChange the fixed price of an offer in one market. Give the offer by sku or offer_id and the market_code
refurbed_delete_market_offerRemove the fixed price of an offer in one market; the price falls back to the calculation from the reference price. Installed switched off
refurbed_get_instanceLook up a refurbed product (instance) by GTIN, MPN or id: id and name. Use the id as instance_id when creating offers. There is no product…
refurbed_list_shipping_profilesList your shipping profiles: id, name, source country, destination markets with costs and delivery times, and how many offers use each.…
refurbed_list_available_carriersList the carriers refurbed can track: name and slug. Use the slug as carrier when shipping with a tracking number instead of a link. Cache…
refurbed_list_marketsList refurbed markets: code (e.g. de, at, fr), name, type, currency_code and is_site (a market with its own refurbed site, where fixed…
refurbed_list_merchant_addressesList your addresses: id, type (DELIVERY or RETURN), company, street, town, post code and country. The id is the sender address of a…
refurbed_get_currencyRead a currency and its exchange rates. Needs no seller data; used to check that the token works

Example prompts

  • "Which refurbed order items are waiting for acceptance?"
  • "Ship order item 9123456 with DHL tracking 00340434161234567890 and IMEI 356789012345678."
  • "What are my offer prices per market for the iPhone 14 128 GB?"
  • "Which returns came in this week?"
  • "How much would a refund of order item 9123456 be?"

FAQ

Where does the API token come from? Request it with refurbed's API token form, from your account manager or [email protected]. Unused tokens expire after two months.

What does it cover? Orders and order items (accept, ship with tracking and IMEI), refund dry runs, shipping labels, invoices, returns, support tickets, offers with stock and prices, per-market prices, product lookup, shipping profiles and carriers.

Which tools install switched off? refurbed_reject_order_item, refurbed_create_shipping_label, refurbed_delete_offer and refurbed_delete_market_offer. 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

Was this guide helpful?

Connect refurbed to Gemini in 2 minutes

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

Related guides

Connectors

Connect refurbed to ChatGPT via MCP: Orders and Offers

refurbed Seller API for sellers of refurbished electronics: orders and order items (accept, ship with tracking and IMEI), refund dry runs, shipping labels, invoices, returns, support tickets, offers with stock and prices, market prices, product lookup, shipping profiles and carriers. API token from refurbed.

Connectors

Connect refurbed to Claude via MCP: Orders and Offers

refurbed Seller API for sellers of refurbished electronics: orders and order items (accept, ship with tracking and IMEI), refund dry runs, shipping labels, invoices, returns, support tickets, offers with stock and prices, market prices, product lookup, shipping profiles and carriers. API token from refurbed.

Connectors

Connect refurbed to Microsoft Copilot via MCP

refurbed Seller API for sellers of refurbished electronics: orders and order items (accept, ship with tracking and IMEI), refund dry runs, shipping labels, invoices, returns, support tickets, offers with stock and prices, market prices, product lookup, shipping profiles and carriers. API token from refurbed.

Connectors

Connect refurbed to Cursor via MCP: Orders and Offers

refurbed Seller API for sellers of refurbished electronics: orders and order items (accept, ship with tracking and IMEI), refund dry runs, shipping labels, invoices, returns, support tickets, offers with stock and prices, market prices, product lookup, shipping profiles and carriers. API token from refurbed.

Connectors

Connect refurbed to Meta Muse via MCP

refurbed Seller API for sellers of refurbished electronics: orders and order items (accept, ship with tracking and IMEI), refund dry runs, shipping labels, invoices, returns, support tickets, offers with stock and prices, market prices, product lookup, shipping profiles and carriers. API token from refurbed.

Connectors

refurbed MCP Server: Orders, Offers and Returns

refurbed Seller API for sellers of refurbished electronics: orders and order items (accept, ship with tracking and IMEI), refund dry runs, shipping labels, invoices, returns, support tickets, offers with stock and prices, market prices, product lookup, shipping profiles and carriers. API token from refurbed.