# Fairing — how to use (mcp.ai)

Connect your Fairing account and use 2 tools for forms and surveys straight from your AI agent. Connect with your own API key. Fairing provides post-purchase attribution surveys, question management, and response data for measuring marketing performance.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_fairing?ms=1787291160000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `fairing_list_questions`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/fairing`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/fairing/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/fairing/list/questions` — Return the connected shop's complete Fairing question stream, optionally including targeting rules.
  - body: { include_targeting?: boolean }
- `POST https://api.mcp.ai/api/fairing/list/responses` — Return one page of the connected shop's survey responses, with optional question, time-window, and sort filters.
  - body: { sort?: string, limit?: integer, next_cursor?: string, question_id?: integer, updated_at_max?: string, updated_at_min?: string, inserted_at_max?: string, inserted_at_min?: string }

## Example prompts
- "What can I do in Fairing?"
- "Show me a summary of my Fairing account"

## More
- Page: https://mcp.ai/fairing
- Agent spec (llms.txt): https://mcp.ai/fairing/llms.txt
- Postman collection: https://mcp.ai/fairing/postman.json