# Faire tools in Cogny Cogny's Faire integration exposes 18 tools (11 read, 6 write, 1 destructive) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app. - **Read** (11): only reads data. - **Write** (6): creates or changes something. - **Destructive** (1): deletes, removes or replaces something. Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. ## Notes Faire is connected from Settings → Integrations with a **brand access token** you generate yourself in the Faire Brand Portal (Settings → API access token). It is the single-brand token path of Faire's External API v2 — no OAuth redirect or app registration. If you don't see an API token option in your Brand Portal, ask Faire support to enable External API access for your brand. Orders, products, product reviews, product types, inventory, prepacks and retailer profiles are **read only**. Writes cover on-hand and available inventory per SKU, wholesale/retail prices per SKU, product field edits, and order actions (accept into processing, add shipments, cancel). Order acceptance, cancellations and shipment tracking notify the retailer; writes stay **ask-first** until you allow them in Settings. No product or variant deletion is exposed. Reviews, retailer profiles and some write operations may be limited for a brand token — read access is centered on your own brand's orders and catalog. ## All tools | Tool | Kind | What it does | |---|---|---| | `get_brand_profile` | Read | Identify the Faire brand the access token belongs to — the connection check and your brand profile. | | `list_orders` | Read | List your Faire wholesale orders, ascending by updated_at, and return the next_cursor for pagination. | | `get_order` | Read | Get one Faire wholesale order by id, with its items, shipments, payout costs and brand discounts. | | `list_products` | Read | List your Faire products with variants, prices and images, and return the next_cursor for pagination. | | `get_product` | Read | Get one Faire product by id, with its variants, prices and images. | | `list_product_reviews` | Read | List Faire product reviews, and return the next_cursor for pagination. | | `list_product_types` | Read | List the Faire product-type taxonomy, and return the next_cursor for pagination. | | `get_inventory_by_skus` | Read | Get per-variant Faire inventory for a list of SKUs (optionally tolerating partial success). | | `get_inventory_by_variant_ids` | Read | Get per-variant Faire inventory for a list of product-variant ids (optionally tolerating partial success). | | `list_prepacks` | Read | List the prepacks of a Faire product (bundled quantities retailers order). | | `get_retailer` | Read | Get the Faire retailer profile for a retailer id seen on an order. | | `update_inventory_by_skus` | Write | Set on-hand Faire inventory per SKU. Each inventory entry is {"sku": ..., "on_hand_quantity": ...}; this changes the quantity retailers can order. | | `update_available_inventory_by_skus` | Write | Set available Faire inventory per SKU. Each inventory entry is {"sku": ..., "on_hand_quantity": ...}; this changes the sellable quantity retailers see. | | `update_prices_by_skus` | Write | Set Faire wholesale/retail prices per SKU. Each entry is {"sku": ..., "wholesale_price": {"amount_minor": int, "currency": "USD"}, "retail_price": {...}}. Changes the prices retailers see. | | `update_product` | Write | Edit a Faire product's fields (name, description, sale_state, ...) by id. | | `accept_order` | Write | Accept a Faire order and move it to processing; the retailer is notified. | | `add_order_shipments` | Write | Add shipment tracking to a Faire order. | | `cancel_order` | Destructive | Cancel a Faire order with a reason and optional note; the retailer is notified. | Exact input schemas come from `tools/list` once Faire is connected; the free plan is enough to check. Missing something? Your agent can ask for it with `request_feature`. --- All integrations: https://cogny.com/integrations/tools/index.md Plans, approvals, limits and data protection: https://cogny.com/buying-guide.md What Cogny is: https://cogny.com/llms.txt