# Faire MCP connector

The Faire connector brings your wholesale orders, products, inventory, prices and retailer reviews into Claude, ChatGPT, Cursor and any MCP client, so your team can ask about and update Faire from the tools they already use.

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

## Facts

| | |
| --- | --- |
| Application | Faire |
| Category | Ecommerce |
| AI tools | 40 |
| Authentication | Connects with an API key |
| 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 | No. 40 tools is past the 30-tool threshold, so clients use `search_tools` and `execute_tool` |

## What you can ask once Faire is connected

- Which Faire orders shipped late this week?
- Summarize inventory gaps across Faire product variants.
- List Faire orders still awaiting packing slips.

## Connect Faire in Elaichi

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

1. Open Connections, choose Add connection, and pick Faire.
2. Optionally set Share with, then press Connect.
3. Paste a Faire API key. One person generates a token in Faire and pastes it once. Everyone else works through Share with, and never sees it.

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

## Connect Faire 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 Faire 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 Faire 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 Faire 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 Faire 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 Faire through Elaichi

### Check on a retailer's order before the call

Wholesale sales. Pull up a Faire order by its number, see what the retailer bought and where it stands, and walk into the conversation knowing what they are waiting on.

### Work through today's orders in one pass

Fulfillment. List the Faire orders that need attention, mark a batch as processing, print the packing slip for each and record the shipment once the carton leaves the warehouse.

### Fix stock levels before retailers overorder

Inventory. Look up on-hand quantities by SKU, then update a whole list of variants at once when a production run lands or a line sells through, and mark items unavailable when they are gone.

### Add and tidy products in the catalog

Merchandising. Create a new Faire product, upload its images, pick the right product type and update the description or options without opening the brand portal.

### Roll out wholesale price changes by SKU

Pricing. Change prices across dozens of Faire variants in one go when costs move or a season ends, instead of editing each listing by hand.

### Handle cancellations and read retailer reviews

Customer service. Cancel a Faire order when a retailer asks, and skim the latest product reviews to spot a packaging or quality issue before it spreads.

## Frequently asked questions

### How do I connect Faire to Claude?

First connect Faire in Elaichi by pasting in your Faire API key. There is no OAuth application to register and no client ID or secret to generate. Then in Claude open Customize, then Connectors, then Add, and paste the endpoint https://api.elaichi.ai/mcp. After you sign in to Elaichi, Faire is ready to use in Claude.

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

Yes. Once Faire is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, any MCP client and the Elaichi agent. You connect Faire once and every client picks it up.

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

It can list your Faire orders, open a specific order, mark orders as processing, cancel one, fetch a packing slip and record a shipment. It can also look up and update inventory and prices by SKU or variant, create and edit products, upload product images, and read retailer reviews. Short, specific asks such as 'show open Faire orders from this week' work better than long paragraphs.

### Does connecting Faire give the AI access to my whole brand account?

The AI can only reach what the Faire API key you connected can reach, and it always acts as the person who signed in to Elaichi. Elaichi can narrow that further, for example limiting a team to reading orders, but it can never grant more than the underlying Faire access allows.

### Can my team share one Faire connection?

Yes. One person connects Faire in Elaichi and shares the connection with a team, so nobody else ever handles the Faire API key. Each teammate still signs in to Elaichi as themselves, so every order update or price change in the audit log is tied to a named person.

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

Yes. In Elaichi you can restrict individual actions on the Faire connection, such as deleting a product, cancelling an order or updating prices. A blocked action is never shown to Claude, ChatGPT, Cursor or any other client, so no prompt, however worded, can reach it.

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

When you offboard someone in Elaichi, their access to Faire through every AI client ends immediately. A shared Faire connection keeps working for the rest of the team. If you want to remove Faire entirely, disconnecting it once in Elaichi removes it from every client at the same time.

## All 40 Faire tools

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

- **List all Faire brands profiles** (List). Get the Faire brand profile associated with the current session. Returns: brand_id, name, currency, locale. No caller-supplied parameters are required — the brand is determined by the authenticated session.
- **List all Faire orders** (List). List Faire orders ordered ascending by updated_at. Returns: id, display_id, created_at, updated_at, state, items, shipments, address, ship_after, payout_costs, payment_initiated_at, original_order_id, retailer_id, source, expected_ship_date, customer, brand_discounts, requested_ship_date, processing_at, is_free_shipping, free_shipping_reason, faire_covered_shipping_cost, estimated_payout_at,…
- **Get single Faire order by ID** (Get). Get a single Faire order by id. Returns: id, display_id, created_at, updated_at, state, items, shipments, address, ship_after, payout_costs, payment_initiated_at, original_order_id, retailer_id, source, expected_ship_date, customer, brand_discounts, requested_ship_date, processing_at, is_free_shipping, free_shipping_reason, faire_covered_shipping_cost, estimated_payout_at, is_fulfilled_by_faire,…. Required: id.
- **Faire orders cancel** (Cancel). Cancel a Faire order, moving it to CANCELED state. The order can be canceled only if its current state is NEW, PROCESSING, PENDING_RETAILER_CONFIRMATION, or BACKORDERED. Returns: id, display_id, created_at, updated_at, state, items, shipments, address, ship_after, payout_costs, payment_initiated_at, original_order_id, retailer_id, source, expected_ship_date, customer, brand_discounts,…. Required: order_id.
- **Create a Faire items availability** (Create). Edit item availability for items in a Faire order. Returns the updated order object (ExternalOrderV2) including its id and additional order attributes. Required: order_id.
- **Get single Faire order packing slip PDF by ID** (Get). Download the PDF packing slip for a Faire brand order. Returns the packing slip as a PDF binary download. For Upmarket Plus retailers, include a printed copy in every shipping package. Required: id.
- **Faire order processings bulk update** (Update). Accept a Faire order and move it to the PROCESSING state. Returns the full order object (ExternalOrderV2) including its id and additional order attributes. Required: order_id.
- **Create a Faire order shipment** (Create). Add shipments to a Faire order, moving its state to PRE_TRANSIT. Returns the updated order including id, state, created_at, and updated_at. For Upmarket Plus retailers, include a packing slip in every shipping package. Required: order_id.
- **Faire available by product variant IDS bulk update** (Update). Update available inventory levels for product variants in Faire identified by their product variant IDs. Returns the updated available inventory response as defined by the Faire API's UpdateAvailableInventoryResponseV2 schema. Requires a request body containing the inventory level updates.
- **Faire available by skus bulk update** (Update). Update available inventory levels for product variants in Faire identified by their variant SKUs. Returns the updated inventory response confirming the available inventory levels.
- **List all Faire product inventory by product variant IDS** (List). List Faire product inventory levels by product variant IDs. Returns the inventory response object as defined by the upstream GetInventoryResponseV2 schema.
- **Faire product inventory by product variant IDS bulk update** (Update). Update on-hand inventory levels for Faire product variants by their product variant IDs. Returns the updated on-hand inventory response object.
- **List all Faire product inventory by skus** (List). Fetch on-hand inventory levels for Faire product variants identified by their SKUs. Returns: inventories. Optional: skus.
- **Faire product inventory by skus bulk update** (Update). Update on-hand inventory levels for Faire product variants identified by their SKUs. Returns: inventories.
- **Faire product prices by product variant IDS bulk update** (Update). Update prices for multiple Faire product variants in a single batch request, identified by their product variant IDs. Returns the batch price update response.
- **Faire product prices by skus bulk update** (Update). Update prices for multiple Faire product variants in a single batch request, identified by their SKUs. Returns a successful response confirming the applied price changes.
- **List all Faire products** (List). List Faire products ordered ascending by updated_at. Returns: id, created_at, updated_at, brand_id, name, description, short_description, sale_state, lifecycle_state, variants, idempotence_token, unit_multiplier, minimum_order_quantity, per_style_minimum_order_quantity, allow_sales_when_out_of_stock, images, variant_option_sets, taxonomy_type, preorderable, preorder_details, product_attributes,…
- **Create a Faire product** (Create). Create a single Faire product in the specified lifecycle_state. Returns: id, created_at, updated_at, brand_id, name, description, short_description, sale_state, lifecycle_state, variants, idempotence_token, unit_multiplier, minimum_order_quantity, per_style_minimum_order_quantity, allow_sales_when_out_of_stock, images, variant_option_sets, taxonomy_type, preorderable, preorder_details,…
- **Get single Faire product by ID** (Get). Get a single Faire product by id, regardless of state (active or deleted). Returns: id, created_at, updated_at, brand_id, name, description, short_description, sale_state, lifecycle_state, variants, idempotence_token, unit_multiplier, minimum_order_quantity, per_style_minimum_order_quantity, allow_sales_when_out_of_stock, images, variant_option_sets, taxonomy_type, preorderable, preorder_details,…. Required: id.
- **Update a Faire product by ID** (Update). Update a single Faire product by id. Variants can be updated or created, but prepacks must use the prepack APIs. Returns: id, created_at, updated_at, brand_id, name, description, short_description, sale_state, lifecycle_state, variants, idempotence_token, unit_multiplier, minimum_order_quantity, per_style_minimum_order_quantity, allow_sales_when_out_of_stock, images, variant_option_sets,…. Required: id.
- **Delete a Faire product by ID** (Delete). Delete a single Faire product by id, setting its lifecycle_state to DELETED so it is no longer visible on Faire. Returns an empty response on success. Required: id.
- **List all Faire products reviews** (List). List Faire product reviews. Returns: id, created_at, updated_at, attributes.
- **List all Faire products types** (List). List all Faire taxonomy types (also called product types) used to categorize brands and products in the Faire marketplace. Returns: id, name.
- **Create a Faire products upload image** (Create). Upload an image to Faire before using it on a product or variant. Returns a response confirming the image is valid and accessible. Faire recommends calling this before creating or updating products to get immediate validation feedback.
- **List all Faire product custom tags** (List). List brand-defined product organization tags for a Faire product. Tags are identified by name, not by ID, and are returned in alphabetical order using the stored spelling. Returns: custom_tags. Required: product_id.
- **Faire product custom tags bulk update** (Update). Replace all brand-defined product organization tags on a Faire product by submitting the full list of tag names; tags absent from the list are removed and an empty list clears all tags. Returns: custom_tags. Each name must be at most 20 characters; at most 250 tags per product; names must be unique including case differences. Required: product_id.
- **Faire product geo restrictions bulk update** (Update). Replace the full list of countries and states where a Faire product is NOT available for sale. Submit the complete list; entries absent are removed and an empty list makes the product available everywhere the brand ships. Returns the stored restrictions sorted by country then state, each entry with country and state_or_province. Duplicate entries are rejected. Required: product_id.
- **Delete a Faire product image by ID** (Delete). Delete an image from a Faire product. Returns an empty response on success. Published products need at least one image; attempting to remove the last image returns 400 Bad Request. Required: id, product_id.
- **Faire product lead times bulk delete** (Delete). Clear the product-level custom lead time override for a Faire product, restoring the brand-level lead time fallback. Idempotent when no override exists; Returns an empty 204 response on success. Returns an empty 204 response on success. Required: product_id.
- **List all Faire product prepacks** (List). List all active prepacks for a Faire product. Returns each prepack with its id, name, description, created_at, and updated_at. Required: product_id.
- **Create a Faire product prepack** (Create). Create a prepack for a Faire product. Returns the created prepack object including its id, name, description, created_at, and updated_at. Required: product_id.
- **Delete a Faire product prepack by ID** (Delete). Delete a Faire prepack by id. Deleted prepacks cannot be re-activated. Returns an empty 200 response on success. Required: id, product_id.
- **Get single Faire product prepack by ID** (Get). Get a single Faire prepack by id. Returns: id, idempotence_token, created_at, updated_at, name, description, items, lifecycle_state. Required: id, product_id.
- **Create a Faire prepacks batch** (Create). Create multiple prepacks for a Faire product in a single batch request. Returns the created prepacks response object. Required: product_id.
- **Faire product variant option sets bulk update** (Update). Replace the variant option sets of a Faire product with the given new sets. Returns: variant_option_sets. Options currently in use by variants cannot be removed; for prepack products, size options cannot be reorganized or have new values inserted mid-sequence. Required: product_id.
- **Create a Faire product variant** (Create). POST /products/{product_id}/variants. Returns: id, created_at, updated_at, product_id, name, sale_state, lifecycle_state, idempotence_token. Required: product_id.
- **Update a Faire product variant by ID** (Update). Update a Faire product variant by id, sending only the fields you want to modify. A variant's options cannot be updated; to change options, delete the variant and create a new one. Returns: id, created_at, updated_at, product_id, name, sale_state, lifecycle_state, idempotence_token, sku, available_quantity, backordered_until, wholesale_price_cents, retail_price_cents, tariff_code, images,…. Required: id, product_id.
- **Delete a Faire product variant by ID** (Delete). Delete a Faire product variant by id. The variant's lifecycle_state is set to DELETED and it is no longer visible on Faire. A product must have at least one non-deleted variant; to remove the last variant, delete the product instead. Returns an empty 200 response on success. Required: id, product_id.
- **Delete a Faire variant image by ID** (Delete). Delete an image from a Faire product variant. Returns an empty 204 response on success. Required: id, product_id, variant_id.
- **Get single Faire retailers public by ID** (Get). Get a Faire retailer's public profile by id, including whether the retailer requires a packing slip in every shipping package when fulfilling orders. Returns: retailer_id, name, is_insider, is_upmarket_plus_retailer, business_identifiers. Required: id.