How to Use the Culture Amp MCP in LangChain

Q: Can I trace Culture Amp API calls inside LangChain using LangSmith?

Yes, every tool call like listemployees or getsurveydetails appears as a distinct run in your LangSmith dashboard. You will see the exact inputs, latency, and outputs returned by the Culture Amp MCP Server.

Q: How does LangChain handle multi-step Culture Amp surveys?

Your LangChain agent uses ReAct loops to call listengagementsurveys first, inspects the status, and then calls getsurveydetails for specific metrics. The output of the first tool guides the agent's next choice in the chain.

Q: How does the Culture Amp MCP Server protect employee directory state?

All mutations to your employee directory state via createemployeerecord run in Vinkius's secure, ephemeral V8 isolate sandboxes. Your raw Culture Amp credentials never touch the LangChain client directly, preventing token exposure during execution.

Build multi-step LangChain pipelines that query Culture Amp employee data and run feedback surveys automatically.

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 LangChain

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate employee onboarding in LangChain

The `create_employee_record` tool writes new hire data directly into your Culture Amp directory. Your LangChain agent triggers this tool immediately after a user gets added to your HR database, keeping your directories in sync without manual entry. By feeding this tool into a LangGraph chain, you can automatically run `list_organizational_groups` to map the employee to the correct team. LangSmith traces every step of this multi-step directory update so you can verify the exact payload sent to the Culture Amp MCP Server.

Chain engagement analytics to demographic data

The `list_engagement_surveys` tool pulls active and closed feedback cycles directly into your LangChain reasoning loops using our managed MCP Server. This lets your agent inspect active survey states before deciding which metrics to pull next. Your chain then feeds those survey IDs into `list_demographic_fields` to break down responses by department or tenure. Combining these tools in a single LangChain run lets you isolate low-engagement segments without writing custom data-joining scripts.

Run deep employee directory searches via ReAct

The `search_employees_by_name` tool queries your Culture Amp directory to find matching profiles using name or email keywords. This tool gives your LangChain ReAct agent immediate access to employee records during live Slack or chat interactions. Once the agent finds the right profile, it passes the resolved user ID to `get_employee_details` to pull complete profile attributes. This two-step lookup happens entirely within a single LangChain run, giving your agent the context it needs to answer complex HR questions.

Setup guide

Set up Culture Amp MCP in LangChain

Prerequisites

Python 3.10+ installed
langchain-mcp-adapters + langgraph packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install langchain-mcp-adapters langgraph langchain-openai. The MCP adapters package converts MCP tools into native LangChain BaseTool objects.
2

Connect via HTTP transport
Use MultiServerMCPClient with "transport": "http" pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create a ReAct agent
Pass the discovered tools to create_react_agent() from LangGraph. The agent automatically routes Culture Amp tool calls through the MCP protocol.
4

Run with any LLM
Swap ChatOpenAI for ChatAnthropic, ChatGoogleGenerativeAI, or any LangChain-compatible model. The MCP tools work identically across all providers.

agent.py

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI

async with MultiServerMCPClient({
    "culture-amp-mcp": {
        "transport": "http",
        "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    }
}) as client:
    tools = client.get_tools()

    agent = create_react_agent(
        ChatOpenAI(model="gpt-4o"),
        tools,
    )
    result = await agent.ainvoke({
        "messages": "List recent Culture Amp transactions"
    })
    print(result["messages"][-1].content)

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 LangChain

Install langchain-mcp-adapters and use the MultiServerMCPClient to connect to the Culture Amp endpoint. Call client.get_tools() and pass them directly to your agent constructor to let the model run directory searches.

Yes, every tool call like list_employees or get_survey_details appears as a distinct run in your LangSmith dashboard. You will see the exact inputs, latency, and outputs returned by the Culture Amp MCP Server.

Your LangChain agent uses ReAct loops to call list_engagement_surveys first, inspects the status, and then calls get_survey_details for specific metrics. The output of the first tool guides the agent's next choice in the chain.

Yes, you can combine these HR tools with any of LangChain's 500+ integrations in the same agent. This lets your agent pull data from Culture Amp and instantly write a summary to a SQL database or a Google Sheet.

All mutations to your employee directory state via create_employee_record run in Vinkius's secure, ephemeral V8 isolate sandboxes. Your raw Culture Amp credentials never touch the LangChain client directly, preventing token exposure during execution.

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