Voyado MCP Server

The Voyado Model Context Protocol (MCP) server lets you ask questions about your Voyado Customer Engagement data from your AI tool, such as Claude or ChatGPT. You write a question in plain language, and the AI tool gets the data from Customer Engagement and answers.

About the Voyado MCP server

MCP is an open standard that lets AI tools connect to other systems in a standardized way.

Before you start, keep these three things in mind:

• The Voyado MCP server is read-only. It can show you data, but it can't change anything in Customer Engagement or send anything.
• It currently works with Customer Engagement only. Product Discovery isn't included in this version.
• It's a pilot. It's free to use during the pilot, and pricing and additional terms may apply after it ends. Features, data, and limits can change during the pilot. Section 6.2 (Exploratory service) of Voyado's General Terms & Conditions applies to participation in the pilot.

Prerequisites

You need:

• A Customer Engagement account.
• An AI tool that supports remote MCP servers. 

Connect to the Voyado MCP server

You can connect to the Voyado MCP server from Claude, ChatGPT, and Lovable (Available soon).

Connect from Claude

1. In Claude, go to Settings > Connectors and select Browse connectors.
2. Search for Voyado Customer Engagement and select Connect.
3. Enter your tenant ID. You find it in the URL you use to open Customer Engagement. In https://yourcompany.voyado.com, the tenant ID is yourcompany.
4. Sign in with your email and password, the same as you use in Customer Engagement.
5. Turn on the connector in your chat, under the tools menu.

Voyado Customer Engagement is listed as a community connector in Claude. This is the standard label for new connectors in the directory, and it’s part of the registration process. The connector works the same way as any other connector. Read more about connector labels.

Connect from ChatGPT

1. In ChatGPT, go to Settings > Apps and search for Voyado Customer Engagement.
2. Select Connect.
3. Enter your tenant ID when prompted. You find it in the URL you use to open Customer Engagement. In https://yourcompany.voyado.com, the tenant ID is yourcompany.
4. Sign in with the same credentials you use for Customer Engagement.
5. Open a ChatGPT conversation and, if needed, select Voyado Customer Engagement from the available apps or tools.

Connect from Lovable (Available soon)

1. In Lovable, open Connectors from the sidebar and select New MCP server.
2. Enter Voyado Customer Engagement as the name, paste the Voyado MCP server URL (https://engage.voyado.com/mcp), and choose OAuth as the sign-in method.
3. Select Connect.
4. Enter your tenant ID when prompted. You find it in the URL you use to open Customer Engagement. In https://yourcompany.voyado.com, the tenant ID is yourcompany.
5. Sign in with the same credentials you use for Customer Engagement.
6. Open a Lovable project chat and ask a question about your Voyado data. Lovable uses Customer Engagement automatically, so you don't need to pick it.

Check that it works

Ask a simple question, for example: "Using the Voyado MCP, what data can you access?" If the connection works, you get an answer based on your Customer Engagement data.

What you can ask

The Voyado MCP server gives your AI tool read-only access to data from Customer Engagement. Write the question in your own words. You don’t need to use exact wording.

To see all the data you can ask about, including KPIs, breakdowns, and data sets, go to Data available through the Voyado MCP server and agent.

Here are some examples:

Communications

Data about email and short message service (SMS), both manual sendouts and automated messages. You get sent, delivered, open, click, unsubscribe, and bounce numbers, and revenue attributed to messages. You can look at single sendouts, best and worst performers, marketing groups, and target audiences.

• "Show me the results for my last five email sendouts."
• "Which three email sendouts had the highest click-through rate last quarter?"

Sales

Sales data from Customer Engagement: purchases, returns, net revenue, average order value, products, categories, stores, and sales channels. You can also see how much of your sales come from messages.

• "How much of my sales come from campaigns?"
• "What were my five best selling products last month?"

Contacts

Data about your contact base: size, growth, new contacts, and how many you can reach by email and SMS. You can also see how contacts are spread by, for example, age group or city, and check how complete your contact data is.

• "How many contacts do I have, and how many can I reach by email?"
• "How many contacts do I have in Stockholm?"

Automations

Performance data for your email and SMS workflows. You can compare workflows and see how each message inside them performs.

• "Which workflows earn the most revenue per delivered email?"
• "Which messages in my abandoned cart workflow get the most clicks?"

Good to know

Here are some important things to keep in mind:

Mention the Voyado MCP in your question

Start your question with something like "Using the Voyado MCP". If you have other connectors turned on, this makes it clearer where the data should come from.

Answers can differ

AI tools don't always give the exact same answer to the same question.

Format of the response

Your AI tool controls the length and format of the answer, not Voyado. If you want a shorter answer or another format, ask for it. For example: "Answer in five bullet points."

Be specific

Be specific about time period, channel, and market to get the most relevant response.

Data freshness

The data is as up to date as in Customer Engagement. There is no delay.

Data definitions

Key performance indicators (KPIs) use the same definitions as analytics in Customer Engagement. For the definitions, see The new Analytics experience in the Help Center.

Large questions can take time

Questions that cover long periods or lots of data can take longer, or fail. If that happens, try a shorter period or a more specific question.

Rate limits

We apply rate limits to the Voyado MCP server to keep the service stable for all customers. The current limit is 100 requests per five minutes, measured over a rolling window. Limits apply per Voyado account (tenant), not per individual user, so all users in your organization share this limit.

A single question to your AI tool can result in several requests to the MCP server, depending on how the AI tool processes it.

If your organization reaches the limit, your AI tool may temporarily stop returning answers. If this happens, wait a few minutes and try again. Capacity returns gradually as older requests fall outside the five-minute window.

During the pilot, we may adjust these limits without prior notice.

Send us feedback

You can give feedback on the Voyado MCP server directly from your AI tool. Ask it to use the suggest improvement tool, and describe what worked, what didn't, or what you miss. You can also send feedback through any of your Voyado contacts.

Security and data privacy

Access and permissions

• You sign in with your Customer Engagement login. Multi-factor authentication (MFA) is required.
• The AI tool connects with your sign-in token (OAuth). It doesn't get a separate login.
• You only see data that your user can see in Customer Engagement. We check your permissions on every call.
• Access is read-only. The AI tool can look at your data, but it can't change anything.
• Only AI tools that Voyado has approved can connect.
• We keep your data separate from other customers' data. Your sign-in token identifies your organization, and we check that it matches your account before we return any data.

Data sent to your AI provider

When you ask a question, Customer Engagement sends the answer to your AI provider, for example Anthropic if you use Claude. Your agreement with that provider decides how they handle the data. Check that this fits your company's policies.

The AI provider's terms apply. Voyado isn't responsible for the AI tool's behavior, outages, or policy changes.

Support access

If you need help, the Voyado team members supporting you, such as your Voyado contacts and our development team, may sign in to your account to assist you and to verify that the Voyado MCP server works as intended. Support access works the same way as in Customer Engagement. When this happens, data from your account is processed through Voyado's Claude Enterprise account.

Personal data

Personally identifiable information (PII) is data that can identify a person, such as name, email address, phone number, or address.

PII is off by default when you connect to the Voyado MCP server. You decide if you want to include it. To turn it on, contact Voyado Support.

Voyado can't see your PII through external connectors. Data is shared with your AI provider, and their terms govern the data processing.

Remove access

You can disconnect the Voyado connector at any time in your AI tool's settings.

Troubleshooting

I can't connect

• Check that you entered the correct tenant ID. You find it in the URL, for example yourcompany in https://yourcompany.voyado.com/app.
• Check that you can sign in to Customer Engagement with the same email and password.
• Allow pop-ups and redirects for Claude, ChatGPT, or Lovable, then try again.
• Disconnect the connector, then connect it again.

I don't see any Voyado tools

• Turn on the connector in your current chat.
• Start a new chat.
• If you use the desktop app, quit the app completely and open it again.

The answers look wrong or inconsistent

• Start a new chat.
• Be specific about the time period, channel, and market.
• Ask the AI tool which data it used.
• Compare the numbers with the reports in Customer Engagement.

FAQ

Can the MCP server change data in Customer Engagement?

No. It's read-only.

Does it work with Product Discovery?

Not in the pilot. It works with Customer Engagement only.

Which AI tools can I use?

Currently Claude, ChatGPT, and Lovable (Available soon).