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.
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.
- 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.
- Paste it into
REFURBED_API_TOKEN, install and runrefurbed_list_orders. The connector sends it asAuthorization: Plainfollowed by the token. - 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 showsYOUR_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" }
}
}
}
- 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
gemini. - Run
/mcpinside Gemini CLI (orgemini mcp listin your shell) —anythingmcpshould show as connected. - Start prompting — Gemini CLI can now call the
refurbedtools.
Available tools
| Tool | What it does |
|---|---|
refurbed_list_orders | List orders, newest first by default: id, released_at, state (NEW, ACCEPTED, SHIPPED, FULFILLED, CANCELLED and others), labels (e.g.… |
refurbed_get_order | Read one order with all its items: state, labels, customer email, shipping and invoice address (with VAT numbers), totals and settlement… |
refurbed_list_order_items | List the items of one order: id, name, state, sku, totals, commission, taxation, offer data (offer id, grading, warranty, shipping… |
refurbed_get_order_item | Read 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_item | Accept a NEW order item (state ACCEPTED): you confirm you will ship it. Answers the updated item |
refurbed_ship_order_item | Mark 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_item | Change an order item without changing its state: replace the tracking link or carrier tracking number, add identifiers (IMEI, serial)… |
refurbed_batch_update_order_item_states | Change 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_item | Reject (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_refund | Dry run: show what refunding an order item would mean (total_paid, total_refunded, refunded, the refurbed and merchant shares) without… |
refurbed_calculate_order_refund | Dry run: show what refunding all refundable items of an order would come to, without refunding anything |
refurbed_list_shipping_labels | List 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_label | Create 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_invoice | Get a download link (valid 24 hours) for the invoice you uploaded for an order. NOT_FOUND when there is none |
refurbed_list_returns | List returns that run on refurbed return labels: id, order_id, order_item_id, instance_name, identifiers, state (INITIATED, IN_TRANSIT… |
refurbed_list_tickets | List customer support tickets: id, status (OPEN, PENDING, SOLVED, CLOSED), topic, urgency, customer, order and order item… |
refurbed_get_ticket | Read one support ticket with its messages, topic, status, order references and notes |
refurbed_list_offers | List your offers: id, sku, instance_id and instance_name, state (OK, UNVERIFIED, PENDING_REVIEW, REJECTED with rejection_reason), grading… |
refurbed_get_offer | Read one offer by SKU or by id: state, grading, warranty, stock, shipping profiles, taxation, reference prices and the market prices with… |
refurbed_create_offer | Create 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_offer | Change 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_offers | Change 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_offer | Delete 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_offers | List 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_offer | Set 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_offer | Change the fixed price of an offer in one market. Give the offer by sku or offer_id and the market_code |
refurbed_delete_market_offer | Remove 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_instance | Look 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_profiles | List your shipping profiles: id, name, source country, destination markets with costs and delivery times, and how many offers use each.… |
refurbed_list_available_carriers | List 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_markets | List 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_addresses | List your addresses: id, type (DELIVERY or RETURN), company, street, town, post code and country. The id is the sender address of a… |
refurbed_get_currency | Read 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?