Connector guide8-minute read31 MCP tools7 languages

Connect Whatnot to Cursor via MCP: Products and Orders

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.

HCBy HelpCode teamUpdated 8 min read Open-source on GitHub

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

Whatnot

Whatnot

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.

tools

31

Region

INTL

Category

E-commerce

Authentication

Bearer Token

Required env vars

WHATNOT_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

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 Cursor in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Whatnot in the guided setup, then add your MCP URL to Cursor. 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.

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

Whatnot + Cursor

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.

  1. 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.
  2. 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.
  3. Copy the token (it starts with wn_pat_tk_ and is shown only once) into WHATNOT_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 Cursor

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.

Cursor reads MCP servers from ~/.cursor/mcp.json. Add this entry:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
  3. Open Cursor → Settings → MCP and check that anythingmcp is listed and connected.
  4. Start chatting — the agent can now call the Whatnot tools.

Available tools

ToolWhat it does
whatnot_get_current_userThe seller behind the API token: user id, username and display name. Use it to check the connection
whatnot_list_ordersList orders sold by the seller, newest first by default: id, status (pending, pending_fulfillment, completed, cancelled, failed)…
whatnot_get_orderOne order by id with status, buyer, amounts and timestamps. Fulfil orders whose status is pending_fulfillment; pending orders are not ready…
whatnot_list_order_itemsItems 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_itemOne item of an order: product, variant, quantity, price and shipment
whatnot_cancel_orderCancel an order that has not shipped and return the updated order. The buyer is refunded and the cancellation counts against the seller.…
whatnot_list_productsList the seller's products, newest first by default: id, title, description, external_id, category, attributes, options, media…
whatnot_get_productOne product with its category, attributes, options, images, dimension profile and variants (id, sku, price, inventory)
whatnot_create_productCreate a product in the seller's catalog. Whatnot creates one variant per combination of option values (one variant without options).…
whatnot_update_productPartly update a product: title, description, external id, category, attributes, options, images or dimension profile. Fields left out stay…
whatnot_delete_productDelete a product from the seller's catalog. It cannot be undone. Installed switched off
whatnot_list_product_variantsVariants 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_variantOne variant of a product by its UUID: sku, options, price, inventory and image
whatnot_update_product_variantsUpdate 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_inventorySet 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_inventoryChange 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_merchandisingHow 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_merchandisingSet 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_showsUpcoming or live shows a product is assigned to, by scheduled start (latest first by default). Ended and cancelled shows are left out.…
whatnot_list_shipmentsList the seller's shipments, newest first by default: id, status (created, label_generated, dropped_off, in_transit, delivered, cancelled…
whatnot_get_shipmentOne shipment: status, tracking, documents (label), required actions and the buyer address
whatnot_list_shipment_itemsActive items of a shipment: order item ids, products, quantities and dimension profile. Cursor paging, up to 50 per page
whatnot_add_tracking_codeShip 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_labelQueue 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_profilesThe seller's active dimension profiles (package weight and size presets): id, name, weight, dimensions. Use an id when creating a product.…
whatnot_list_showsList the seller's shows with one status (scheduled by default), by scheduled start time, latest first by default: id (UUID), title, status…
whatnot_get_showOne show by id (UUID): title, status, visibility, scheduled start and URL
whatnot_get_show_analyticsAnalytics of one show (sales, viewers and other metrics). A show without final numbers answers with null metrics and calculation_status…
whatnot_generate_reportRequest a report run: seller_financial_report (transactions between start_date and end_date, default one week), analytics_overview_report…
whatnot_list_reportsThe seller's report runs, most recently requested first: id, report_type, status (pending, in_progress, completed, failed, cancelled)…
whatnot_get_reportOne 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.

Does Cursor support custom MCP servers on the free tier? Yes — MCP is available on Hobby, Pro and Business plans.

Next steps

Was this guide helpful?

Connect Whatnot to Cursor in 2 minutes

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

Related guides

Connectors

Connect Whatnot to ChatGPT via MCP: Orders and Stock

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.

Connectors

Connect Whatnot to Claude via MCP: Orders and Shows

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.

Connectors

Connect Whatnot to Microsoft Copilot via MCP

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.

Connectors

Connect Whatnot to Gemini CLI via MCP: Orders and Shows

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.

Connectors

Connect Whatnot to Meta Muse via MCP: Orders and Stock

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.

Connectors

Whatnot MCP Server: Orders, Inventory and Shows

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.