How to Use the Gainsight CS MCP in Mastra AI

Q: How do I install the Gainsight CS MCP Server in Mastra AI?

Run npm install @mastra/mcp@latest in your project. Then initialize MCPClient with your server URL and spread the tools into your agent.

Q: How do I require human approval for timeline updates?

Enable requireToolApproval on the writing tools. The workflow will pause and wait for manual confirmation before executing the API call.

Build resilient customer success workflows in Mastra AI that manage Gainsight CS MCP Server tasks with automatic retries.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gainsight CS MCP to Mastra AI

Create your Vinkius account to connect Gainsight CS to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Gainsight CS with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Branch on Call-to-Action Status

The `list_calls_to_action` tool feeds directly into Mastra AI conditional branches. If an account shows a high churn risk, your workflow routes the data to a senior manager. We follow up with `get_cta_metadata` to pull the exact intervention steps required. You build these paths without worrying about transient API failures. Mastra applies exponential backoff automatically if the initial fetch times out. The agent keeps trying until it gets the data.

Automated Timeline Logging

Your workflow triggers the `log_timeline_activity` tool after a billing event fails. The agent records the failure in the customer history immediately. It then runs `get_person_details` to find the billing contact for the next step. If the write operation drops, the built-in retry engine catches it. You can also enforce a human-in-the-loop check using Mastra's requireToolApproval before writing sensitive updates to the timeline.

Mastra AI MCP Server Task Resolution

This MCP Server pulls active workload queues into your agent logic via the `list_cockpit_tasks` tool. The agent evaluates the task list and decides which items need immediate attention. It uses `get_task_metadata` to read the specific requirements for each job. You deploy this entire logic chain to your cloud provider with one command. The server handles the underlying transport, whether it detects SSE or Streamable HTTP.

Setup guide

Set up Gainsight CS MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Gainsight CS tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "gainsight-cs-mcp-client",
  servers: {
    "gainsight-cs-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Gainsight CS Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Gainsight CS tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Gainsight CS transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Gainsight CS. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Gainsight CS now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Gainsight CS MCP in Mastra AI

Run `npm install @mastra/mcp@latest` in your project. Then initialize `MCPClient` with your server URL and spread the tools into your agent.

Yes. If the logging tool fails due to a network error, the workflow engine applies exponential backoff and attempts the write again.

No. Mastra auto-detects whether the endpoint requires Streamable HTTP or SSE and configures the connection.

Enable `requireToolApproval` on the writing tools. The workflow will pause and wait for manual confirmation before executing the API call.

This setup processes sensitive customer relationship notes. The Vinkius ephemeral architecture ensures no data persists on disk after the workflow completes its execution cycle.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript