Start Free trial

Articles in this section

Connect VWO with AI Tools using VWO’s MCP Server

Jash Unadkat
  • Updated
Share:
Follow
close this to read article
Feature Availability: The VWO MCP server is exclusively available on the Enterprise plan. 

This article covers the following:

Overview

The VWO Model Context Protocol (MCP) server is a secure connection layer that enables external AI tools, such as ChatGPT, n8n, or other automation systems, to connect with your VWO account. It allows these tools to directly access and analyze your live VWO campaign data and insights using simple natural-language queries. Think of it as a secure digital bridge that turns VWO data into an AI-native app, eliminating the need to manually export reports and copy/paste data for external analysis or workflow automation.

Integrating third-party AI tools like ChatGPT with the VWO MCP server offers the following benefits:

  • Instant, on-demand insights: You get data-backed answers for any questions around your campaign in seconds. This prevents you from navigating through multiple screens or exporting CSVs.
  • Effortless data analysis: Use natural language to ask complex questions about your experiments and user behavior.
  • Automated workflows: Connect VWO to automation platforms (such as n8n or Zapier) to create powerful, cross-platform workflows, including automated weekly reports sent directly to Slack.
  • Deep integration: Allow your AI assistant to fetch and segment all the data available in your VWO account.

Let us understand the use of the VWO MCP server better with a few use cases:

  • For the Product Marketer: Instantly identify campaigns that are not producing a clear winner. Ask, Tell me about the campaigns that do not have a winner in the last 3 months? to get a complete list and start optimizing.
     
  • For the Conversion Rate Optimization (CRO) Experts: Get a comprehensive behavioral summary for a key page. Ask, Can you access my heatmap for vwo.com/pricing and give me insights? to receive key takeaways, frustration indicators, and even visual heatmap previews.
     
  • For the Data Analysts: Quickly drill down into user session recordings for deeper context. Ask follow-up questions like, What about session recordings for the same timeframe and page? to get a summarized breakdown of user interactions, device splits, and top regions.

This article further explains how you can connect the VWO MCP server with third-party AI tools. 
In this article, we will use ChatGPT as an example.

Connect VWO MCP Server with ChatGPT

Prerequisites:

  • You must have a VWO Enterprise plan.
  • You must have an OpenAI ChatGPT account with Pro or Plus subscription.
  • You must have permission to generate a Developer API token within your VWO account.

Follow the steps below to integrate the VWO MCP server with your ChatGPT account:

Step 1: Locate your MCP Server URL

First, you need the MCP URL that connects ChatGPT to your VWO account data.

  1. Log in to your VWO account.
  2. Scroll down to the bottom of the dashboard and click Developer resources.
  3. Go to the VWO MCP Server tab. Here you will find the MCP server URL required for the integration.
API-Token.png

Step 2: Generate your VWO Developer API Token

The MCP server URL contains a placeholder, DEV_API_TOKEN. Replace this with your personal Developer API token. This token securely authenticates your requests.

To create your personal developer API token:

  1. On the Developer Dashboard, go to the Tokens tab.
  2. Click Add another API token.
  3. Enter the token name, select the permission type as Browse, and click Generate.

The Browse permission ensures that your token is allowed to access and view resources on the server. Without this permission, the server will be unable to return any data, and your request may fail or result in an empty response.
generate-token.png

Note: The MCP server currently supports only Read operations, which means it can fetch or retrieve information but cannot create, update, or delete anything. As a result, your API token must have the Browse permission enabled.

Once you click Generate, a token appears. Use this newly generated token in the DEV_API_TOKEN placeholder of the MCP server URL.

Tip: Your Developer API token provides access to your VWO data. Treat it like a password and do not share it publicly.

Step 3: Configure the Custom VWO Connector in ChatGPT

Note: Use the official ChatGPT website to follow the steps below.

To add VWO as a custom connector within ChatGPT:

  1. Log in to your ChatGPT account.
  2. Go to Settings > Apps & Connectors > Advanced settings > Developer mode.
  3. Toggle on the Developer mode. This allows you to add and configure custom connectors.
    enable-developer-mode.png
  4. Navigate back to Apps & Connectors and click Create to create a new custom connector.
  5.  Enter the following configuration details for the VWO connector:
    • Name: Enter a name that helps you recognize the connector (VWO in this case).
    • Description: Provide a short description that describes the capabilities of the connector.
    • MCP server URL: Enter the following MCP server URL: https://mcp.vwo.io/mcp?key=YOUR_DEV_API_TOKEN
      Note: Ensure you replace YOUR_DEV_API_TOKEN with the actual token you generated in Step 2.
    • Authentication: Select No authentication from the dropdown, as additional authentication is not required.
    • Select the I understand and want to continue checkbox.
    • Click Create.

After you click Create, the MCP URL gets validated. Upon successful validation, your VWO connector will be ready for use. 

Step 4: Query Your VWO Data Using Natural Language

Once the VWO connector is configured, activate it before asking campaign-related queries. To activate the connector:

  1. On your ChatGPT account dashboard, navigate to the Ask anything field and click +.
  2. Go to More and select VWO. This activates the VWO connector.
    vwo-connector.png
  3. Start asking your questions in natural language. To answer your questions, ChatGPT calls the VWO MCP server to fetch the relevant data.

If the query is successful, the system displays a Calling tool message in the ChatGPT interface before the results appear. This indicates that the connector is working successfully. 

For best results, make your questions as specific as possible. Include campaign names, page URLs, and date ranges (for example, share the progress of campaigns that were published in the last 7 days). 

Tip: The MCP server has access to comprehensive data, including not only A/B test outcomes but also VWO Insights information, such as heatmaps, session recordings, and other relevant metrics. To make the most of these insights, frame your questions around specific goals or hypotheses so the responses align with your optimization strategy.

Troubleshooting

Issue

Possible Cause

Recommended Solution
Error with connection or invalid token. Incorrect Developer API token, a revoked token, or an incorrect MCP server URL.

If ChatGPT cannot connect to VWO, double-check that you have correctly copied and pasted your Developer API token into the server URL.

Ensure the token is active and has not been revoked.

FAQs

  • What is the difference between the VWO MCP Server and VWO Copilot?
    The VWO MCP server is a headless backend system that enables external tools, such as ChatGPT, to connect to your VWO data. VWO Copilot is a self-contained, in-app assistant that helps you with tasks inside the VWO platform. 
  • Can I use the MCP Server to create a new test or pause a campaign?
    No. The current version of the VWO MCP server is read-only. It can fetch and analyze data, but it cannot perform Write actions back into your VWO account.

Need more help?

For further assistance or more information, contact VWO Support.

 

Was this article helpful?

Return to top

Related articles