Summary
Whatnot Seller API for sellers on the live shopping marketplace: orders, order items, shipments and tracking codes, products and variants, inventory, merchandising for buy it now, auctions and shows, show analytics and reports. Personal access token.
Guided setup
Connect Whatnot to Microsoft Copilot in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Whatnot 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 Whatnot
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 → Whatnot, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Whatnot + Microsoft Copilot
Whatnot Seller API for sellers on the live shopping marketplace: orders, order items, shipments and tracking codes, products and variants, inventory, merchandising for buy it now, auctions and shows, show analytics and reports. Personal access token.
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:
WHATNOT_API_TOKEN
Step 1 — Get credentials
Setting up takes about 2 minutes.
- Sign in to Whatnot with the seller account owner and open the developer dashboard, tab Personal access tokens (https://www.whatnot.com/dashboard/developer?tab=tokens). Only the account owner can create tokens.
- Click Generate new token, give it a name, choose an expiration (7 to 90 days, a custom date or no expiration) and the permissions: read and write for inventory, merchandising, orders and shipments, read for shows, read and write for reports, and read customers if the agent should see buyer names. Write access includes read access.
- Copy the token (it starts with
wn_pat_tk_and is shown only once) intoWHATNOT_API_TOKEN.
The Seller API is still marked beta by Whatnot: fields can change.
Where to start: whatnot_get_current_user checks the token. whatnot_list_orders shows recent orders; fulfil those with status pending_fulfillment. whatnot_list_products lists the catalog.
Orders and shipping: whatnot_list_orders, whatnot_get_order, whatnot_list_order_items, whatnot_get_order_item. Each order item belongs to a shipment: whatnot_list_shipments, whatnot_get_shipment, whatnot_list_shipment_items. Ship with your own label through whatnot_add_tracking_code (order item ids, carrier, tracking code). whatnot_generate_shipping_label (Whatnot label, may cost money) and whatnot_cancel_order (refunds the buyer) are installed switched off.
Listing a product: 1) whatnot_list_dimension_profiles for a package profile id, 2) whatnot_create_product with title, leaf category id from Whatnot's public taxonomy (https://github.com/Whatnot-Inc/product-taxonomy) and the profile, 3) whatnot_list_product_variants for the variant ids, 4) whatnot_update_product_variants for prices, 5) whatnot_set_inventory for stock, 6) whatnot_update_product_merchandising to choose buy_it_now or auction and publish. Change products with whatnot_update_product, read them with whatnot_get_product and whatnot_get_product_variant. whatnot_delete_product is installed switched off.
Inventory: whatnot_set_inventory (absolute) and whatnot_adjust_inventory (delta) take up to 10 variants per call; give every item a fresh idempotency_key (a UUID) so a retry is applied only once.
Shows and merchandising: whatnot_list_shows (status scheduled by default), whatnot_get_show, whatnot_get_show_analytics, whatnot_get_product_merchandising, whatnot_list_product_shows. Adding a product to a show uses show ids (UUID) in whatnot_update_product_merchandising with strategy ADD, REMOVE or REPLACE.
Reports: whatnot_generate_report starts a financial, analytics overview or livestreams report; poll whatnot_get_report or whatnot_list_reports until the status is completed.
Paging: lists take limit (1 to 50, default 10) and return data plus next_cursor; pass it as cursor until it is null.
Ids and formats: order, product, shipment and order item ids are digits (send them as text); variant, show and report ids are UUIDs. Money is an object with amount as text in whole units (19.99) and currency. Times are ISO 8601 in UTC with milliseconds (2026-11-01T00:00:00.000Z).
Errors and limits: errors are problem+json with type, title, detail (a missing-scope error lists required_scopes: edit the token's permissions); a 422 for a malformed request lists each field under detail with loc and msg. The limit is 10 requests per second per seller and app; a 429 carries Retry-After in seconds.
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
Whatnottools. - 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 |
|---|---|
whatnot_get_current_user | The seller behind the API token: user id, username and display name. Use it to check the connection |
whatnot_list_orders | List orders sold by the seller, newest first by default: id, status (pending, pending_fulfillment, completed, cancelled, failed)… |
whatnot_get_order | One order by id with status, buyer, amounts and timestamps. Fulfil orders whose status is pending_fulfillment; pending orders are not ready… |
whatnot_list_order_items | Items of one order: item id, product, variant, quantity, price, and the shipment each item belongs to. Cursor paging, up to 50 per page |
whatnot_get_order_item | One item of an order: product, variant, quantity, price and shipment |
whatnot_cancel_order | Cancel an order that has not shipped and return the updated order. The buyer is refunded and the cancellation counts against the seller.… |
whatnot_list_products | List the seller's products, newest first by default: id, title, description, external_id, category, attributes, options, media… |
whatnot_get_product | One product with its category, attributes, options, images, dimension profile and variants (id, sku, price, inventory) |
whatnot_create_product | Create a product in the seller's catalog. Whatnot creates one variant per combination of option values (one variant without options).… |
whatnot_update_product | Partly update a product: title, description, external id, category, attributes, options, images or dimension profile. Fields left out stay… |
whatnot_delete_product | Delete a product from the seller's catalog. It cannot be undone. Installed switched off |
whatnot_list_product_variants | Variants of a product: variant id (UUID), sku, external_id, selected option values, price, inventory and image. Cursor paging, up to 50 per… |
whatnot_get_product_variant | One variant of a product by its UUID: sku, options, price, inventory and image |
whatnot_update_product_variants | Update up to 10 variants of one product: price (under the product's sale format), sku, external id, country of origin or image. Fields left… |
whatnot_set_inventory | Set the available quantity of up to 10 variants to an absolute value. Each item needs a unique idempotency_key (a new UUID per change); a… |
whatnot_adjust_inventory | Change the available quantity of up to 10 variants by a delta (negative to reduce; a result below zero becomes 0). Each item needs a unique… |
whatnot_get_product_merchandising | How and where a product is sold: transaction_type (buy_it_now or auction), reserve_for_live and whether it is assigned to upcoming or live… |
whatnot_update_product_merchandising | Set a product's sale format, reserve it for live shows, or add it to or remove it from shows, in one call; fields left out stay unchanged.… |
whatnot_list_product_shows | Upcoming or live shows a product is assigned to, by scheduled start (latest first by default). Ended and cancelled shows are left out.… |
whatnot_list_shipments | List the seller's shipments, newest first by default: id, status (created, label_generated, dropped_off, in_transit, delivered, cancelled… |
whatnot_get_shipment | One shipment: status, tracking, documents (label), required actions and the buyer address |
whatnot_list_shipment_items | Active items of a shipment: order item ids, products, quantities and dimension profile. Cursor paging, up to 50 per page |
whatnot_add_tracking_code | Ship order items under a tracking code from the seller's own label. The items must go to the same buyer and address and must not have been… |
whatnot_generate_shipping_label | Queue a Whatnot shipping label for a shipment with its saved settings. 200 means queued, not created; the label arrives through Whatnot's… |
whatnot_list_dimension_profiles | The seller's active dimension profiles (package weight and size presets): id, name, weight, dimensions. Use an id when creating a product.… |
whatnot_list_shows | List the seller's shows with one status (scheduled by default), by scheduled start time, latest first by default: id (UUID), title, status… |
whatnot_get_show | One show by id (UUID): title, status, visibility, scheduled start and URL |
whatnot_get_show_analytics | Analytics of one show (sales, viewers and other metrics). A show without final numbers answers with null metrics and calculation_status… |
whatnot_generate_report | Request a report run: seller_financial_report (transactions between start_date and end_date, default one week), analytics_overview_report… |
whatnot_list_reports | The seller's report runs, most recently requested first: id, report_type, status (pending, in_progress, completed, failed, cancelled)… |
whatnot_get_report | One report run by id (UUID): status and, when completed, the link to download the file |
Example prompts
- "Which Whatnot orders from last night's show still need shipping?"
- "Add UPS tracking 1Z999AA10123456784 to shipment 778899."
- "Set the inventory of variant SKU WN-CARD-PK1 to 50."
- "How did my last show perform: viewers, sales and revenue?"
- "Generate a sales report for October."
FAQ
Where does the token come from? Whatnot developer dashboard, tab Personal access tokens, created by the account owner with the permissions the tools need. It is shown once. The Seller API is still marked beta by Whatnot.
What does it cover? Orders, order items, shipments and tracking codes, products and variants, inventory, merchandising for buy it now, auctions and shows, show analytics and reports.
Which tools install switched off? whatnot_cancel_order, whatnot_delete_product and whatnot_generate_shipping_label. Switch them on on the connector page only if the AI should use them.
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?