Windsor MCP

🚀 Windsor MCP Server

Windsor MCP (Model Context Protocol) allows your LLM to query, explore, and analyze your full - stack business data integrated into Windsor.ai without writing any SQL or custom scripting. It seamlessly connects to over 325 platforms, providing AI - native tools like Claude, Perplexity, Cursor, etc., with real - time access to your performance marketing, sales, and customer data to uncover valuable insights.

🚀 Quick Start

View our official documentation: https://windsor.ai/introducing-windsor-mcp/

✨ Features

Natural language access to business data

Windsor MCP is a natural language interface that links your integrated Windsor.ai datasets with the LLM platform. You can gain a better understanding of your data by asking questions such as:

• “What campaigns had the best ROAS last month?”
• “Give me a breakdown of spend by channel over the past 90 days.”
• “What campaigns are wasting our advertising budget?”

All these queries can be made in real - time directly within your LLM chat interface.

Out - of - the - box integration with 325+ sources

Sync data from Facebook Ads, GA4, HubSpot, Salesforce, Shopify, TikTok Ads, and more through native Windsor.ai connectors.

Zero - code setup

Windsor MCP operates via the Claude Desktop or a lightweight dev proxy, eliminating the need for custom integrations.

Open standard compatibility

Built on Anthropic’s open MCP spec, it is compatible with Claude, Perplexity, Cursor, and more.

Real - time Analytics without SQL

Get instant breakdowns, summaries, and performance insights from your integrated data.

📚 Documentation

🎯 How It Works

You connect Windsor MCP to your preferred LLM as an external connector using the MCP protocol. The LLM can then issue real - time data queries and receive structured results, all within the chat interface.

Example prompts:

• What was total ad spend by channel last month?
• Break down ROAS for Meta vs Google Ads for Q2
• Are there any campaigns overspending vs target ROAS?

Installation Options

Option 1: Claude Desktop (Recommended)

Prerequisites:

• Claude Pro or a higher - tier Claude Desktop plan
• Your Windsor API key

Steps:

1. Go to Claude settings → Connectors → Add custom connector
2. Use one of the following URLs for Windsor MCP:
   • https://mcp.windsor.ai
   • https://mcp.windsor.ai/sse
3. Open a new chat and start with:

My Windsor.ai API key is {your-key}. {Your question here}

4. Accept connector permissions and start querying your data!

Option 2: Developer Proxy Setup

This is for users on lower - tier Claude plans or those requiring custom setups for advanced flexibility.

Prerequisites:

• Claude Desktop with dev mode enabled

Installation steps:

1. Install mcp - proxy and copy its path.

uv tool install mcp - proxy
which mcp - proxy  # Copy full path

2. Configure Claude Desktop: Open Settings → Developer → Edit Config and add:

{
  "mcpServers": {
    "windsor": {
      "command": "/Users/{your-username}/.local/bin/mcp - proxy",
      "args": ["https://mcp.windsor.ai/sse"]
    }
  }
}

💡 Replace <your - username> with your system username.

3. Fully quit and reopen Claude. You should now see “windsor” listed in your MCP options.

Option 3: Windsor MCP with Cursor

Prerequisites:

• Cursor Desktop installed
• Your Windsor API key

Installation steps:

1. Install mcp - proxy

uv tool install mcp - proxy
which mcp - proxy  # Copy full path

2. Open settings in Cursor Desktop. Select Tool & Integrations > New MCP Server.
3. The mcp.json file will open. Paste the following script into it:

{
  "mcpServers": {
    "windsor": {
      "command": "/Users/{your-username}/.local/bin/mcp - proxy",
      "args": ["https://mcp.windsor.ai/sse"]
    }
  }
}

4. Windsor MCP will now become active in Cursor. It will ask for Windsor’s API Key in a prompt; just paste it, and you are good to go with any questions related to your data.

Option 4: Windsor MCP with Gemini CLI

Installation steps:

1. Install mcp - proxy

uv tool install mcp - proxy
which mcp - proxy  # Copy full path

2. Install Gemini CLI Use Node.js to globally install the Gemini CLI (make sure you have Node.js 18 or later installed).

npm install -g @google/gemini - cli

3. Configure Gemini to use Windsor MCP Navigate to the Gemini config directory:

cd ~/.gemini

If the .gemini directory doesn’t exist yet, run gemini once to generate it. Open the settings.json file:

nano settings.json

Add the following configuration inside the JSON object:

{
  "mcpServers": {
    "windsor": {
      "command": "/Users/{your-username}/.local/bin/mcp - proxy",
      "args": ["https://mcp.windsor.ai/sse"]
    }
  }
}

Note: Make sure the overall file remains valid JSON (no trailing commas or syntax errors).

4. Start Gemini with Windsor MCP Now, simply run Gemini:

gemini

You’ll be asked for your Windsor API key — paste it in to authenticate. You’re all set now!

❓ FAQs

Is Windsor MCP free to use?

Yes, it's available during our beta phase. You’ll need a Windsor.ai account with integrated data and API key access. But keep in mind that Claude Desktop allows you to add external connectors only on the paid plans.

What agents does it work with?

Any AI agent compatible with MCP, including Claude Desktop, Perplexity, Cursor, and custom tools.

What can I ask Windsor MCP?

Marketing performance, sales pipelines, spend summaries, ROAS trends, campaign anomalies, and more. If it’s in your Windsor.ai data, you can ask it.

Do I need to write SQL or set up dashboards?

No. Just ask your questions in plain English and get structured responses in real - time.

🧪 Beta Status

Windsor MCP is currently in beta. All features are fully functional, but you may encounter occasional quirks. We're actively improving performance, authentication, compatibility, and feature coverage.

🧠 Try It Now

Start querying your business data via Windsor MCP.
👉 Get your API Key
👉 Watch the demo

For support or feedback, contact us at support@windsor.ai.