# Social Fanout Quickstart

Use this flow to publish through connected and approved social destinations.

## 1. Create an API key

Start from `https://socialfanout.com/signup` or the dashboard. Paid checkout provisions a paid API key after Stripe returns a completed session.

## 2. Sign in to the dashboard

Use `https://socialfanout.com/login` and open the dashboard to manage API keys, provider connections, jobs, posts, and billing visibility.

## 3. Connect destinations

Open the dashboard connections view and authorize supported providers. Provider availability can depend on approval, OAuth scopes, account permissions, and app-review status.

## 4. Publish with REST

```bash
curl https://socialfanout.com/v1/publish \
  -H "content-type: application/json" \
  -H "x-api-key: spk_..." \
  -d '{
    "accountId": "conn_...",
    "platform": "bluesky",
    "connectionId": "conn_...",
    "text": "Hello from Social Fanout",
    "mediaUrls": []
  }'
```

Social Fanout v1 publishes to one connected destination per request. Call `/v1/publish` once per destination when you want to fan out to multiple accounts.

## 5. Publish with MCP

Run the local stdio MCP server with the same API key:

```bash
FANOUT_API_KEY=spk_... npm run mcp
```

Configure your MCP-compatible agent client to launch that local command. The MCP tools call the hosted REST API underneath.

## Notes

- Limits are scoped to API keys.
- Free keys include 100 publish attempts per month and 2 destination platform types.
- Paid plan limits are visible in the dashboard for the selected API key.
- TikTok and Pinterest production publishing remain approval-gated until live provider sign-off is confirmed.