How to Use the Culture Amp MCP in Mastra AI

Q: How do I add Culture Amp tools to Mastra AI?

Initialize a new MCPClient with your Vinkius server URL. Call mcpClient.listTools() and spread the result directly into your Agent tools array.

Build resilient HR workflows and automate Culture Amp directory changes using Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Culture Amp MCP to Mastra AI

Create your Vinkius account to connect Culture Amp 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 Culture Amp with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Surveys with Mastra AI

HR operations break when APIs time out. You build workflows using this MCP server that call `list_engagement_surveys` to check active campaigns, and the framework automatically retries with exponential backoff if a network error occurs. Once the survey list resolves, your logic branches based on the lifecycle status. The agent hits `get_survey_details` for active ones and pipes participant counts into your internal reporting tool.

Map Organizational Hierarchies Safely

Restructuring teams requires careful validation. Your agent pulls current group structures using `list_organizational_groups` and matches them against `list_cultureamp_accounts`. You configure requireToolApproval for the mutation step. The workflow pauses, a human reviews the planned changes, and then the agent executes `create_employee_record` to finalize the directory updates.

Analyze Demographics via MCP Server

Extracting segmented analytics usually takes hours of spreadsheet formatting. The agent grabs target segments via `list_demographic_fields` and identifies the corresponding reporting buckets using `list_analytics_datasets`. You deploy this extraction job to your cloud provider with a single command. The background process runs autonomously, grabbing the latest demographic splits without any manual intervention.

Setup guide

Set up Culture Amp 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 Culture Amp 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: "culture-amp-mcp-client",
  servers: {
    "culture-amp-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Culture Amp 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 Culture Amp. 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 Culture Amp 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 Culture Amp MCP in Mastra AI

Initialize a new `MCPClient` with your Vinkius server URL. Call `mcpClient.listTools()` and spread the result directly into your Agent tools array.

The built-in engine handles backoff automatically. If a massive query using `list_employees` hits a limit, the agent waits and tries again.

Yes. You flag specific tools to require human-in-the-loop validation before execution. This prevents accidental directory mutations.

The client auto-detects between Streamable HTTP or SSE based on the endpoint. You just provide the URL and it negotiates the connection.

Every operation runs inside a zero-trust V8 isolate. When your workflow pulls hierarchical classifications from the organizational mapping boundary, the MCP server destroys the sandbox immediately after the job finishes.

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