How to Use the Culture Amp MCP in OpenAI Agents SDK

Q: How do I connect the Culture Amp MCP Server to the OpenAI Agents SDK?

Install the openai-agents package first. Create an MCPServerStreamableHttp object with your Vinkius URL, then pass it in the mcpservers array when building your agent. The SDK finds all the HR tools without extra configuration.

Q: Can OpenAI Agents SDK modify Culture Amp data?

Yes. Your agent can call createemployeerecord to add new staff members. You should configure OpenAI guardrails to validate these inputs before the agent executes the mutation.

Q: How do I pull participation metrics across multiple accounts?

Your agent first calls listcultureampaccounts to find all organizational scopes. It then iterates through those IDs, pulling listanalyticsdatasets to aggregate the reporting data across your entire enterprise.

Build production-ready HR agents that manage engagement surveys and employee data using the OpenAI Agents SDK.

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 OpenAI Agents SDK

Create your Vinkius account to connect Culture Amp to OpenAI Agents SDK 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 OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate employee onboarding workflows

Your multi-agent system needs a reliable way to update the company directory when someone gets hired. Connecting this MCP Server gives your agents direct write access to HR records. They parse incoming requests, validate the details using OpenAI guardrails, and execute the creation step. Calling `create_employee_record` pushes new hires straight into the system. You'll then trigger specialized agents to fetch their newly generated IDs via `get_employee_details` and assign them to specific departments using `list_organizational_groups`. Everything tracks back through your OpenAI dashboard for auditing.

Run deep engagement analytics

Fetching participation metrics manually just wastes time. Your agents pull raw survey data directly into their context window and summarize company morale trends. They inspect active feedback cycles and immediately flag departments with low response rates. Handoffs make this process incredibly powerful. An analysis agent runs `list_engagement_surveys` to find recent polls, then passes the IDs to a reporting agent. That second agent calls `get_survey_details` and `list_demographic_fields` to map out exactly which teams need attention.

Connect Culture Amp to OpenAI Agents SDK

Setting up this integration requires minimal boilerplate. You create an `MCPServerStreamableHttp` instance pointing to your Vinkius endpoint and pass it to your agent constructor. The framework handles tool discovery automatically. Searching for specific staff members happens instantly. When a user asks about a manager's direct reports, the agent fires off `search_employees_by_name` or `list_employees` to find the exact profile. Set `cacheToolsList=True` in your configuration to keep response times sharp during high-volume queries.

Setup guide

Set up Culture Amp MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Culture Amp tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Culture Amp tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Culture Amp tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Culture Amp Agent",
            instructions="You have access to Culture Amp tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 OpenAI Agents SDK

Install the `openai-agents` package first. Create an `MCPServerStreamableHttp` object with your Vinkius URL, then pass it in the `mcp_servers` array when building your agent. The SDK finds all the HR tools without extra configuration.

Yes. Your agent can call `create_employee_record` to add new staff members. You should configure OpenAI guardrails to validate these inputs before the agent executes the mutation.

Production deployments require strict auditing. Every time your agent fetches HR data or lists surveys, the OpenAI dashboard traces the exact tool call and parameters. You see exactly what the agent did with your employee directory.

Your agent first calls `list_cultureamp_accounts` to find all organizational scopes. It then iterates through those IDs, pulling `list_analytics_datasets` to aggregate the reporting data across your entire enterprise.

Vinkius runs your server in an ephemeral V8 Isolate Sandbox. When your agent pulls sensitive demographic fields or personal emails via `get_employee_details`, that data never persists on our infrastructure. The zero-trust architecture ensures your HR records remain strictly between your OpenAI environment and the API.

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