# Wayfair MCP connector

The Wayfair connector brings dropship and CastleGate purchase orders, inventory, fulfillment orders and catalog items into Claude, ChatGPT, Cursor and any MCP client, so your team can work Wayfair orders and stock from the AI they already use.

Source: https://elaichi.ai/connectors/wayfair/

## Facts

| | |
| --- | --- |
| Application | Wayfair |
| Category | Ecommerce |
| AI tools | 27 |
| Authentication | App credentials |
| Needs your own OAuth app | No |
| MCP endpoint | https://api.elaichi.ai/mcp |
| Works with | Claude, ChatGPT, Cursor, any MCP client, and the Elaichi Agent |
| Tools advertised by name | Yes |

## What you can ask once Wayfair is connected

- Which Wayfair dropship purchase orders are waiting to ship?
- Summarize this week's Wayfair fulfillment order cancelations.
- Show inventory adjustments across all Wayfair warehouses.

## Connect Wayfair in Elaichi

This happens once for the organization, before any client is involved.

1. Open Connections, choose Add connection, and pick Wayfair.
2. Optionally set Share with, then press Connect.
3. Paste your Wayfair app credentials. Wayfair authenticates the app rather than a person. One person supplies the credentials once, and everyone else works through Share with.

Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which Wayfair tools are exposed, rename them, or freeze arguments before anyone points a client at it.

## Connect Wayfair to Claude

Endpoint: https://api.elaichi.ai/mcp

1. Open Customize, then Connectors.
2. Press Add.
3. Name it, paste the MCP server URL, then Continue.
4. Sign in and approve.

On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves.

## Connect Wayfair to ChatGPT

Endpoint: https://api.elaichi.ai/mcp

1. Open Plugins, then press the + button.
2. Name it and paste the endpoint into Server URL.
3. Leave Authentication on OAuth, then tick the risk acknowledgement.
4. Press Create, then sign in and approve.

Works on the web today. The plugin directory lives at chatgpt.com/plugins.

## Connect Wayfair to Cursor

Endpoint: https://api.elaichi.ai/mcp

1. Open `~/.cursor/mcp.json`.
2. Add the endpoint under `mcpServers`.
3. Reload Cursor, then sign in and approve.

Set up per machine, so repeat it on each computer you work from.

## Connect Wayfair to any MCP client

Endpoint: https://api.elaichi.ai/mcp

1. Add the endpoint as a remote MCP server.
2. Sign in and approve.

The Elaichi Agent already has these tools, with nothing to set up.

## What the consent screen decides

Only Read is granted by default, which is not enough to call a Wayfair tool. Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Grant Read and Run tools. Think hard before granting Delete, which reaches into connected apps and cannot be undone.

## What teams do with Wayfair through Elaichi

### Accept the morning's dropship purchase orders

Operations. Ask for every new Wayfair dropship purchase order, review them in one list, and accept the ones you can fill before the acceptance window closes.

### Mark dropship orders shipped with tracking

Warehouse. When boxes leave the dock, tell the agent the carrier and tracking numbers and it ships the matching Wayfair purchase orders so the customer gets notified.

### Push today's stock counts to Wayfair

Inventory. Save updated quantities for your SKUs and check the inventory summaries and recent adjustments to make sure Wayfair is not selling what you no longer have.

### Acknowledge CastleGate orders and shipping advices

Supply chain. Pull the open CastleGate purchase orders and shipping advices, confirm what you can supply, and acknowledge them without opening Partner Home.

### Create, check and cancel fulfillment orders

Fulfillment. Raise a fulfillment order for a customer shipment, look one up by its ID when someone calls to ask where it is, and cancel it if the order falls through.

### Submit new products and fix catalog listings

Merchandising. Draft a product addition against the right Wayfair taxonomy category and brand, track the submission and any questions Wayfair asks, and update catalog items or item groups when details change.

## Frequently asked questions

### How do I connect Wayfair to Claude?

Connect Wayfair in Elaichi first: pick Wayfair from the catalog and paste in the app credentials from your Wayfair supplier account. There is no OAuth application to register and no client ID or secret to generate. Then open Claude, go to Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp as the endpoint. Sign in with your Elaichi account and Wayfair purchase orders, inventory and catalog items are available in your chat.

### Does Wayfair work with ChatGPT and Cursor as well as Claude?

Yes. Once Wayfair is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, any other MCP client and the Elaichi Agent. You connect Wayfair once and every client your team uses can reach it.

### What can an AI agent actually do with my Wayfair data?

With Wayfair connected, an agent can list your dropship and CastleGate purchase orders, accept or acknowledge them, and mark dropship orders as shipped with tracking. It can save inventory quantities, show inventory summaries and adjustments, create, look up and cancel fulfillment orders, and read warehouse and CastleGate shipping advices. On the catalog side it can submit product additions, follow up on submission questions, browse Wayfair taxonomy categories, brands and media tags, and update catalog items and item groups.

### Does connecting Wayfair give the AI access to my whole supplier account?

The AI only reaches what the Wayfair account you connected can reach, so it works inside the same supplier permissions you already have in Wayfair. Elaichi can narrow that further, for example read-only on purchase orders for one team, but it can never widen it beyond what Wayfair itself allows. Every call is recorded in an append-only audit log.

### Can my team share one Wayfair connection?

Yes. One person connects Wayfair in Elaichi and shares the connection with a team, and nobody else ever handles the Wayfair app credentials. Each teammate still signs in to Elaichi as themselves, so the audit log names the person who accepted a purchase order or changed a stock count, not a shared account.

### Can I stop an agent from deleting or changing things in Wayfair?

Yes. Restrictions in Elaichi work per action, so you can allow reading Wayfair purchase orders and inventory while blocking shipping, canceling fulfillment orders or updating catalog items. A blocked action is never advertised to Claude, ChatGPT or Cursor at all, so no prompt, however worded, can reach it.

### What happens to a Wayfair connection when someone leaves?

When you offboard someone in Elaichi, their access to Wayfair through every client ends at once. A shared Wayfair connection keeps working for everyone else on the team, because it does not depend on the person who left. If you ever want to remove Wayfair entirely, disconnecting it once in Elaichi removes it from Claude, ChatGPT, Cursor and every other client together.

## All 27 Wayfair tools

Every tool below is callable through https://api.elaichi.ai/mcp once Wayfair is connected, subject to the toolbox it is in and the restrictions on the caller.

- **List all Wayfair dropship purchase orders** (List). List Wayfair dropship purchase orders, sorted by purchase order date. Returns purchase orders with id, poNumber, poDate, status, supplier and customer addresses, shippingInfo, warehouse, and products. Default limit 10; pass has_response=false to retrieve open purchase orders.
- **Wayfair dropship purchase orders accept** (Accept). Accept line items on a Wayfair dropship purchase order. Returns the transaction status including id, handle, status, submittedAt, itemCount, and per-item errors. Required: po_number, ship_speed, line_items. Max 10 line items per request.
- **Wayfair dropship purchase orders ship** (Action). Send a Wayfair Advanced Shipment Notification (ASN) confirming that purchase order items have shipped and updating customer tracking. Returns the transaction status including handle, status, submittedAt, itemCount, and per-item errors. Required: notice. Max 10 line items per request.
- **List all Wayfair castlegate purchase orders** (List). List Wayfair CastleGate purchase orders via the getCastleGatePurchaseOrders GraphQL query. Returns: poNumber, poDate, status. Limit defaults to 10 with a max of 25; poll ideally every 30 minutes.
- **Wayfair castlegate purchase orders acknowledge** (Action). Acknowledge receipt of a Wayfair CastleGate purchase order. Returns: handle, status, errors. Required: po_number. Rate limited to 1 request per 3 seconds.
- **List all Wayfair castlegate shipping advices** (List). List CastleGate warehouse shipping advices (WSAs) in Wayfair. Returns each advice with wsaId, shipDate, carrierCode, and a products array with quantityOrdered and quantityShipped. Optional filters: from_date, has_response, wsa_ids, sort_order, limit.
- **Wayfair castlegate shipping advices acknowledge** (Action). Acknowledge one or more CastleGate warehouse shipping advices in Wayfair by wsa_ids. Returns: handle, status, errors. Required: wsa_ids.
- **Wayfair inventory save** (Action). Save inventory line items in Wayfair by submitting an inventory feed via the SaveInventory GraphQL mutation. Returns: handle, status. Required: inventory. Send a TRUE_UP full feed at least every 24 hours and DIFFERENTIAL partial feeds for production updates; the sandbox accepts TRUE_UP only with a maximum of 500 line items.
- **List all Wayfair inventory adjustments** (List). List CastleGate inventory adjustments in Wayfair. Returns each adjustment record with eventDate, adjustmentType, supplierPartNumber, quantity, description, and the warehouse (warehouseId, name, address) where it occurred. Required: supplier_id.
- **List all Wayfair inventory summaries** (List). List Wayfair inventory position summaries by supplier part, including CastleGate and physical retail on-hand breakdowns per warehouse. Returns: supplierPartNumber, sku, productName, manufacturerPartId, options, inventoryPosition. Required: supplier_id. filter.supplierPartNumbers accepts 1-100 part numbers; omit filter to query all parts.
- **Create a Wayfair fulfillment order** (Create). Create a Wayfair multi-channel fulfillment order with customer, retailer, item, shipping, and address details. Returns: fulfillmentOrderRequestId, requestStatus (ACCEPTED/REJECTED/PROCESSING), and errors. Required: fulfillment_order_input. Up to 10 items per request.
- **Get single Wayfair fulfillment order by ID** (Get). Get detailed information for a single Wayfair multi-channel fulfillment order, identified by supplierId plus fulfillmentOrderRequestId. Returns: fulfillmentOrder (requestId, status, statusLabel, orderDate, customerOrderNumber, retailer, items with statuses and trackingNumbers) and fulfillmentOrderErrors. Required: order_details_input containing supplierId and fulfillmentOrderRequestId.
- **List all Wayfair fulfillment orders** (List). List all Wayfair multi-channel fulfillment orders for a supplier, paginated. Returns: pageInfo (hasNextPage, hasPreviousPage, totalPages, totalItems) and nodes, each holding a fulfillmentOrder (requestId, status, statusLabel, orderDate, customerOrderNumber, retailer, items) plus fulfillmentOrderErrors. Required: order_details_list_input containing supplierId.
- **Wayfair fulfillment orders cancel** (Cancel). Cancel a Wayfair multi-channel fulfillment order by aggregatorOrderId and supplierId. Returns: aggregatorOrderId, order-level errors, and per-item results (fulfillmentOrderItemId, supplierPartNumber, requestStatus, errors). Required: cancel_fulfillment_order_input containing aggregatorOrderId and supplierId.
- **List all Wayfair warehouse shipping advices** (List). List Wayfair warehouse shipping advices (WSAs) with tracking details for multi-channel fulfillment order items. Returns: fulfillment_order_item_id, warehouse_shipping_advice_date, fulfillment_order_request_id, fulfillment_purchase_order_number, supplier_id, retailer, product_details, shipping_details, tracking. Required: warehouse_shipping_advice_input (with supplierId); fulfillmentOrderItemIds…
- **Create a Wayfair product addition** (Create). Submit new product additions to Wayfair via the productAddition.submit GraphQL mutation. Returns the GraphQL response envelope with data.productAddition.submit.requestIds (poll via productAddition.submissions) and errors. Required: request (supplierId, proposedProductAdditions). Recommended max 100 products per request; manufacturerId and manufacturerName are mutually exclusive.
- **List all Wayfair product addition submissions** (List). List Wayfair product addition submissions for a supplier, optionally narrowed to the request ids returned when the additions were submitted. Returns: supplierId, marketContext. Required: request (with supplierId).
- **List all Wayfair product addition questions** (List). List Wayfair product addition questions (generic and class-specific) for a given supplier, product class, and market context. Returns: id. Required: request.
- **List all Wayfair taxonomy categories** (List). List Wayfair product catalog taxonomy categories for a given market context. Returns the page's pageInfo (page, pageSize, hasNextPage, totalPages) and items with taxonomyCategoryId and name. Required: market_context. pageSize must be one of 10, 20, 25, 50.
- **List all Wayfair brand associations** (List). List Wayfair brand associations for a supplier within a market context via the Product Catalog GraphQL API. Returns: brands (each with id and manufacturer {id, name}) and pageInfo (hasNextPage, hasPreviousPage, totalPages). Required: request.
- **List all Wayfair media metadata tags** (List). List Wayfair Product Catalog media metadata tags for a market context, grouped by tag type (document, legal document, language, region). Returns: metaDataTagType, metaDataTags. Required: media_metadata_tag.
- **List all Wayfair catalog items** (List). List paginated supplier catalog items from Wayfair's Catalog Read API V2. Returns: requestId, supplierId, filter, paginationOptions. Required: input (supplierId; paginationOptions: page >= 1, pageSize 1-30, default 30). Drive pagination from paginationInfo.hasNextPage.
- **Update a Wayfair catalog item by ID** (Update). Update market-specific catalog items (item name, taxonomy attributes) in Wayfair. Returns: requestId, supplierId, filter, paginationOptions. Required: input (supplierId, marketContext, catalogItemsToUpdate with supplierPartNumber; optional itemName, attributes, validateOnly). Up to 500 catalog entities per request.
- **Update a Wayfair catalog item group by ID** (Update). Update Wayfair catalog item groups (item group name, feature bullets, marketing copy) within a specific market context. Returns the GraphQL envelope: data (holding the mutation's requestId, which the caller polls via statusOfUpdateRequest) and errors (message, extensions.category, path) when the request is rejected. Required: input with supplierId, marketContext, catalogItemGroupsToUpdate (each…
- **Update a Wayfair catalog item media by ID** (Update). Update catalog item media in Wayfair via the updateCatalogItemsMedia mutation — attach or replace media by URL and optionally override the item's lead image. Returns: requestId, supplierId, filter, paginationOptions. Required: input (with supplierPartNumber, mediaUrl, mediaType, leadImageOverride). Media updates apply to all market contexts.
- **Get single Wayfair catalog update request by ID** (Get). Get the status of a Wayfair catalog update request (items, item groups, or media) using the supplierId and the requestId returned from the update mutation. Returns: requestId, validationOnly, status, problems (code, message), and successfulUpdates (entityId, entityType). Required: input with supplierId and requestId. A COMPLETED status can still carry per-entity problems.
- **List all Wayfair supplier catalog** (List). List products from a Wayfair supplier catalog via the supplierCatalog GraphQL export. Returns: supplierId. Required: supplier_id. Only one filter type per request; pagination_options.pageSize must be 10, 20, or 25.