# Windsor.ai MCP Server

> Windsor.ai MCP Server connects AI agents to 325+ marketing, advertising,
> analytics, e-commerce, CRM, and database sources via the Model Context
> Protocol. Query live data from Meta Ads (Facebook & Instagram), Google Ads,
> TikTok Ads, LinkedIn Ads, Microsoft Ads (Bing), Snapchat Ads, Pinterest Ads,
> Google Analytics 4, HubSpot, Salesforce, Klaviyo, Shopify, Stripe, BigQuery,
> Snowflake and more — directly from Claude, ChatGPT, Microsoft Copilot,
> Perplexity, Cursor, Gemini, Manus, or any MCP-compatible client.

## Quick Start

- MCP endpoint (Streamable HTTP): https://mcp.windsor.ai/
- MCP endpoint (SSE): https://mcp.windsor.ai/sse/
- Authentication: OAuth 2.0 (recommended) or Windsor.ai API key (Bearer token)

## Documentation

- [Setup guides hub](https://windsor.ai/documentation/windsor-mcp/) —
  step-by-step setup per AI client.
- [Full reference for LLMs](https://mcp.windsor.ai/llms-full.txt)
- [HTML documentation](https://mcp.windsor.ai/docs)
- [Available data sources (JSON)](https://mcp.windsor.ai/datasources)
- [OAuth metadata](https://mcp.windsor.ai/.well-known/oauth-authorization-server)
- [Windsor.ai homepage](https://windsor.ai/)

## Available Tools

- `get_current_user`: Return the authenticated user's profile (username, email).
- `get_connectors`: List Windsor.ai connectors and their connected accounts.
  Pass `include_not_yet_connected=True` to also see connectors the user can set up.
- `get_connector_authorization_url`: Get a browser link to connect or authorize
  a connector (works for OAuth and manual credential connectors).
- `get_options`: List fields, date filters and connector-specific options for
  a given connector and account set.
- `get_fields`: Get descriptions, types and tables for specific fields.
- `get_data`: Run a query against a connector with date ranges, filters,
  options and account selection.

## Compatible Clients

Per-client setup guides live at
https://windsor.ai/documentation/windsor-mcp/.

- Claude (Desktop, Web, Code) — one-click install:
  https://claude.ai/directory/360c0c31-4bb6-42ca-8e50-5da0a100a68e
  Setup guide:
  https://windsor.ai/documentation/windsor-mcp/how-to-integrate-data-into-claude/
- ChatGPT — one-click install:
  https://chatgpt.com/apps/windsor-ai/asdk_app_694a52cfaa3c819192bea84eaa254968
  Setup guide:
  https://windsor.ai/documentation/windsor-mcp/how-to-integrate-data-into-chatgpt/
- Microsoft Copilot — Windsor.ai Power Platform connector:
  https://learn.microsoft.com/en-us/connectors/windsorai/
  Setup guide:
  https://windsor.ai/documentation/windsor-mcp/how-to-integrate-data-into-copilot-agent/
- Perplexity — setup guide:
  https://windsor.ai/documentation/windsor-mcp/how-to-integrate-data-into-perplexity/
- Cursor plugin: https://github.com/windsor-ai/windsor-ai-cursor-plugin
  Setup guide:
  https://windsor.ai/documentation/windsor-mcp/how-to-integrate-data-into-cursor/
- Claude Code — install with `claude plugin install windsor-ai`. Source:
  https://github.com/windsor-ai/claude-windsor-ai-plugin
- Manus — setup guide:
  https://windsor.ai/documentation/windsor-mcp/how-to-integrate-data-into-manus-ai/
- Gemini CLI — setup guide:
  https://windsor.ai/documentation/windsor-mcp/how-to-integrate-data-into-gemini/
- Windsurf, Cline, GitHub Copilot, n8n, mcp-proxy, and any application built
  on the MCP open standard. Generic setup guide:
  https://windsor.ai/documentation/windsor-mcp/how-to-connect-windsor-mcp-to-any-ai-client/