windsor-ai

# Windsor.ai Analytics

Use this skill to query, explore, and analyze your [Windsor.ai](https://windsor.ai) connected and business data using natural language. Windsor.ai aggregates data from 325+ platforms: Facebook Ads, Google Analytics 4, HubSpot, Shopify, TikTok Ads, Salesforce, and hundreds more and exposes it through a single MCP interface.

## When to Use This Skill

Invoke this skill automatically when the user asks questions about:
- Campaign performance, ROAS, CPM, CPC, CTR
- Ad spend breakdowns or budget analysis across channels
- Sales pipeline, CRM data, or customer acquisition metrics
- E-commerce performance (revenue, conversion rates, AOV)
- Cross channel attribution or multi touch analytics
- Trend analysis over specific date ranges
- Data from any connected advertising, analytics, or CRM platform

The user can also invoke this skill directly with `/windsor-ai`.

## Setup

Before querying data, the Windsor.ai MCP connection must be configured. Follow these steps once:

### Step 1: Get Your Windsor.ai API Key

1. Log in to your Windsor.ai account at https://windsor.ai
2. Navigate to your account dashboard or settings
3. Locate the API Key section and copy your key

### Step 2: Store the API Key

Add your API key to the clawdbot environment file:

```bash
echo 'WINDSOR_API_KEY=your_api_key_here' >> ~/.clawdbot/.env
```

Replace `your_api_key_here` with the key you copied.

Then export it for your current session so mcporter can resolve it:

```bash
export WINDSOR_API_KEY=your_api_key_here
```

> **Note:** mcporter requires `WINDSOR_API_KEY` to be exported as a shell environment variable. Simply storing it in `~/.clawdbot/.env` is not enough — it must be available in your active shell session.
>
> **Security note:** Avoid appending the key to `~/.zshrc` or other shell rc files, as this stores your secret in plaintext and loads it into every shell session. Prefer your system keychain, a secrets manager, or a `.env` file with restricted permissions (`chm...