# Windsor.ai MCP Server

> Windsor.ai MCP Server connects AI agents to 350+ 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 — and *execute write operations* on Meta Ads, Google Ads,
> TikTok Ads, LinkedIn Ads, and Microsoft Ads (manage campaigns, ad sets/groups,
> ads, budgets, and bidding) and Instagram (create image posts, comment on
> posts), plus Google Business Profile, Klaviyo, and Amazon Seller Central —
> 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)
- [Available write actions (JSON)](https://mcp.windsor.ai/actions)
- [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,
  and current subscription plan).
- `get_connectors`: List Windsor.ai connectors, their connected accounts, the
  write actions each connector supports, and the read options each exposes. Pass
  `include_not_yet_connected=True` to also see connectors the user can set up.
- `get_connector_connect_info`: Describe how to grant access to a connector and
  return its direct connect URL.
- `get_connector_authorization_url`: Get a browser link to connect or authorize
  a connector (works for OAuth and manual credential connectors).
- `get_subscription_url`: Get a clickable Markdown link to the Windsor.ai
  pricing page, or to a specific plan's upgrade page.
- `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.
- `get_custom_fields`: List the user's custom (formula) fields across
  connectors — each with its connector, field id, type, and formula.
- `create_custom_field`: Create a custom (formula) field on a connector — a
  calculated metric or dimension (e.g. CPA, or spend adjusted by a margin) that
  then behaves like a normal field in reads and exports. Confirm the field with
  the user first.
- `list_actions`: Discover write operations a connector exposes — e.g. on Meta
  Ads, create / pause / enable / update campaigns, ad sets, and ads, set
  budgets, boost posts, and set Click-to-Message welcome messages; on Google
  Ads, create campaigns / ad groups / ads, pause / enable them, set budgets and
  bidding, manage keywords (add / update / remove, plus negative keywords), and
  manage Customer Match audience lists; TikTok Ads, LinkedIn Ads, and Microsoft
  Ads also expose pause / enable and budget actions, and Instagram can create
  image posts and comment on posts. Beyond ads, Google Business Profile (posts,
  review replies, photos, hours, open status), Klaviyo (create flows, set flow
  status), and Amazon Seller Central (update listings) also expose write
  actions. Returns the JSON schema for each action.
- `execute_action`: Run a write action (e.g. create, pause, or enable a campaign,
  ad set, or ad; set a budget or bid) on a connector account. Reach for this
  whenever you would otherwise *recommend* a change — confirm intent with the
  user first.
- `get_destinations`: List destinations that can receive scheduled exports of
  connector data (BigQuery, Google Sheets, Snowflake, databases, storage) and
  any reusable OAuth credentials.
- `get_destination_tasks`: List the scheduled export tasks the user already
  created, each with its destination, connector, schedule, and status.
- `get_destination_setup_info`: Describe a destination's target fields, allowed
  schedules, and a link to its dashboard setup form.
- `create_destination_task`: Create a recurring export of a connector's data to
  a destination, reusing OAuth the user already granted. Confirm the source,
  target, and schedule with the user first.
- `get_windsor_login_url`: Return a link into the Windsor.ai
  dashboard, optionally deep-linked to a specific page.
- `contact_windsor`: Send feedback, a support request, or a feature request to
  Windsor.ai and return a reference ID.

## 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/
- Google Antigravity — setup guide:
  https://windsor.ai/documentation/windsor-mcp/how-to-integrate-data-into-antigravity/
- Grok (xAI) — add `https://mcp.windsor.ai/` as a Custom Connector at
  https://grok.com/connectors.
- Lovable — add `https://mcp.windsor.ai/` as a Custom MCP. Setup guide:
  https://windsor.ai/documentation/windsor-mcp/how-to-integrate-data-into-lovable/
- Base44 — add `https://mcp.windsor.ai/` under Settings → MCP connections.
- n8n — add an MCP Client Tool node pointing at `https://mcp.windsor.ai/`.
  Setup guide:
  https://windsor.ai/documentation/windsor-mcp/how-to-integrate-windsor-mcp-into-n8n/
- Windsurf, Cline, GitHub Copilot, 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/