What is the Vitally MCP Server?
The Vitally MCP (Model Context Protocol) server connects an MCP-compatible AI client to your Vitally workspace. Once connected, you can ask the AI questions about your customer data in plain language and have it query Vitally on your behalf. The integration also supports "write" actions, so the AI can create records such as Tasks, Notes, and Custom Objects directly in Vitally.
MCP is an open standard for connecting AI clients to external tools and data. Any client that supports MCP can connect to Vitally, including Claude, ChatGPT, and Cursor. The AI runs inside the client you already use; Vitally exposes a set of tools that the client can call.
The MCP server is currently in Beta. The available tools will continue to grow, and some behavior may change during the Beta period. If something does not work as expected, contact your CSM and share the chat transcript.
MCP vs. Vitally Copilot
Vitally Copilot runs natively inside Vitally and has pre-built knowledge of your workspace configuration. The MCP server is the reverse: it brings Vitally data into an outside AI tool you already use for other work. This gives you more flexibility, because you are not limited to the Vitally interface, but it also means the AI does more work to interpret your workspace's specific terminology. A few minutes of setup, described below, closes most of that gap.
Choose Copilot when you want an AI experience purpose-built around Vitally with zero setup required.
Choose the MCP integration when you want Vitally data available inside an AI tool you are already using.
How to Connect an AI Client to Vitally
Setup is a one-time process in your AI client. The exact screen varies by client, but the connection details are the same everywhere.
You'll need permissions to add a Custom Connector. If you are on a Team or Enterprise plan with your AI client, your Workspace Owner will need to enable the Connector at which point individual users within the organization will be able to connect and enable the Connector for themselves. If you have an individual paid plan, you can do this yourself.
Step 1: Add the Vitally MCP server
Add the Vitally MCP server to your AI client using this URL:
https://mcp.vitally.io/mcp/v0
Some clients provide a simple connector field where you paste the URL directly (for example, Claude.ai under Settings, then Connectors). Other clients use a configuration file (for example, Claude Desktop or Cursor). The URL is the same in both cases; consult your client's own documentation for where the connector setting or configuration file lives.
Step 2: Authorize access
After you add the server, your AI client opens a browser window and prompts you to sign in to Vitally and authorize access. This is a standard OAuth consent flow, the same kind used when connecting any other app to your accounts. The consent screen shows the permission scopes the client is requesting. Approve them, and the connection is live.
There is no API key to generate and no credentials to copy and paste. Your client handles registration and authorization automatically the first time you connect.
Access is tied to your Vitally user account. The MCP server respects your existing permissions in Vitally, including Access Groups, so the AI can only see and do what you can do. Any record the AI creates is attributed to you, the same as if you had created it in Vitally directly.
Step 3: Confirm the connection
Ask your AI client a simple question, such as "What accounts do I have in Vitally?" If it returns real data from your workspace, the connection is working.
What You Can Ask the AI To Do
Once connected and configured, you can ask the AI to look up, analyze, and (in some cases) create Vitally records — all in plain language. Here is the complete list of currently supported tools:
Read-Only Tools
Retrieve content
Search accounts
Search conversations
Search custom objects
Search docs
Search goals
Search indicators
Search meetings
Search note
Search NPS responses
Search object properties
Search projects
Search segments
Search tasks
Search team members
Search users
Write Tools
Create custom object
Create note
Create task
Finding and Understanding Records
The AI can search for and retrieve details about accounts, organizations, and users. You can search by name or by external ID, and you can scope a search to a specific account or organization. Examples:
"Which of my accounts have a health score below 40?"
"Show me accounts renewing in the next 60 days with no recent activity."
"What does Acme Corp's health trend look like?"
"What is the MRR for this account?"
Tool names adapt to your workspace's terminology. If your workspace calls accounts something else, the AI's account-lookup tool is named to match, so you can refer to your records using the same words you use inside Vitally.
Digging into Activity and History
The AI can summarize an account's recent activity and history, including notes, meetings, and product feedback. Examples:
"Summarize the last three notes on this account."
"What came up in our last meeting with this customer?"
"Has this account raised any product feedback recently?"
Working with Custom Objects
Your workspace's Custom Objects, such as Risks, Product Requests, or Commitments, are accessible by name. You do not need to know internal IDs. The AI reads each Custom Object's description from your Vitally configuration to understand how to use it. Examples:
"What open Risks do we have logged for this account?"
"List all Product Requests tagged to this customer."
Creating Records
The AI can create records directly in Vitally, including Tasks, Notes, and Custom Object records. Creating a record requires an Account or Organization to attach it to. Examples:
"Create a Task to follow up with this account next Tuesday."
"Log a Note summarizing this conversation."
"Create a Risk record for this account based on what we just discussed."
Write actions run directly, without a separate confirmation step built into the tool. Review what the AI is about to create before you ask it to proceed, the same way you would for any other AI-assisted action with real consequences. This matters most for customer-facing records.
Improving the AI's Answers with Field Descriptions
If a question about a custom field is answered oddly, the cause is usually that the field's description in Vitally does not give the AI enough context to interpret it. Add or improve descriptions on your Traits and Custom Objects in Vitally so the AI has more context about how each one is meant to be used.
Working with Complex, Multi-Step Requests
Multi-step requests work, but you can improve results by breaking them down. A request like, "Find accounts at risk, then check their open tasks, then draft a follow-up plan" asks the AI to chain several actions together on its own. This generally works well, but if a complicated request returns an incomplete or confusing answer, split it into smaller, sequential questions.
You can also prompt the AI to iterate. Ask it directly why something did not work, or ask it to try a different approach, with prompts such as, "Do a deeper analysis on this," "What else can you tell me about X," "Did you miss anything important," or "Try again and take a closer look at the conversations."
Things to Know
The integration is currently in Beta. Available tools will grow over time, and there may be some breaking changes during the Beta period.
The MCP server is not the same as Vitally Copilot. See the section on how the two differ above.
"Write" actions have no built-in confirmation prompt. Review before you confirm, especially for customer-facing records.
The AI acts with your permissions and attributes its actions to you.
The MCP server is Vitally's own hosted connector, and uses each user's login and respects their permissions.
You can set the integration to "read-only" in your LLM by restricting the write tools in your AI tools' settings.
This beta is covered by Vitally's existing security and privacy commitments.
Token Usage
When you connect the Vitally MCP server, you use your own AI client and its subscription. Any tokens consumed by a conversation are billed through your client (for example, your Claude, ChatGPT, or Cursor plan), not through Vitally. This is the same for any MCP server or connector you attach to your AI client, whether it is Vitally, Notion, or another tool. Connecting to Vitally through the MCP does not change how your AI client bills you.
Questions or Feedback?
The MCP server is in Beta, and it is actively being improved based on how you use it. If something does not work the way you expect, or you hit a wall doing something that feels like it should be possible, tell your CSM and share the chat transcript. That feedback goes directly into what gets built next.
