# Faire Sync

> Sell wholesale on Faire from your OpoShop store. Set your wholesale terms per product, see exactly what you keep before you publish, and fulfil Faire orders from one place.

This app is built on the OpoShop platform. It is agent-friendly: the full
API is described in OpenAPI and wrapped by an MCP server so an LLM can drive it
directly.

## Machine interfaces
- API contract (OpenAPI): https://app.usefairesync.com/openapi.json
- API docs (Swagger): https://app.usefairesync.com/docs
- Fuller LLM context: https://app.usefairesync.com/llms-full.txt
- Release notes: https://app.usefairesync.com/api/release-notes
- MCP endpoint (hosted): https://app.usefairesync.com/mcp. See Auth below before trying to connect.

## What it is for
Faire is a WHOLESALE marketplace: independent retailers buy from brands at
wholesale and resell at retail. That means a Faire price is not an OpoShop price,
and no percentage relates the two.

So Faire Sync never infers a wholesale price. The merchant enters the wholesale
price, the suggested retail price, the order minimum, the case pack and the lead
time for every product, and a product cannot be published until they have. Every
price carries a provenance stamp naming who entered it and when, and the Faire
client refuses to transmit any price lacking one. There is no bulk publish
anywhere in the API.

## Auth
The API and the /mcp endpoint accept a Faire Sync session token as
`Authorization: Bearer <token>`. Sessions are created when a merchant opens Faire
Sync from their OpoShop admin. There is no self-serve way to create a token for
an outside tool yet. Email brandon@tryfound.io to ask for access.

## Independence
Faire is a trademark of Faire Wholesale, Inc. Faire Sync is an independent application that connects to Faire through its public API, and is not endorsed or certified by Faire.