Faïença Broderie developer portal

Public catalog API, OpenAPI, UCP MCP, and permission scopes. No key is required to read products. Payment always needs buyer approval.

Quickstart

  1. Read agent instructions: /agents.md
  2. Discover UCP: /.well-known/ucp
  3. Call the MCP server (tools only): https://faienca.fr/api/ucp/mcp
  4. Import the OpenAPI specification: /pages/openapi
  5. Read the MCP manifest: /pages/mcp

Catalog reads: zero authentication. No key to create. Live proof: GET /products.json. Storefront GraphQL sandbox: mock.shop.

curl -sS https://faienca.fr/products.json

Scopes

  • ucp.catalog.read — Product search, prices, and availability
  • ucp.cart.write — Create and update carts
  • ucp.checkout.write — Checkout; payment still needs human approval
  • ucp.orders.read — Order tracking for the authenticated buyer

JSON errors

*.json routes and MCP respond with JSON. An error object includes a code, a message, and a recovery hint. Do not parse an HTML 404 page as an API response.

{
  "error": {
    "code": "not_found",
    "message": "Unknown product handle",
    "hint": "List products via /products.json or search_catalog on MCP"
  }
}

Sandbox

To try Storefront GraphQL without this shop, use mock.shop (sample data, no auth). On faienca.fr, products.json and UCP MCP are the live surface.

Self-serve API keys: not required. Catalog JSON and the MCP manifest are public. UCP checkout asks the buyer for approval; there is no contact-sales form.

llms.txt · Pricing · products.json