How to Use the Assembled MCP in LangChain

Q: How do I connect the Assembled MCP Server to LangChain?

Install langchain-mcp-adapters and langgraph. Pass the Vinkius endpoint URL into MultiServerMCPClient. Your code reads the tools automatically through client.gettools().

Q: Can LangChain ReAct agents update Assembled schedules?

These tools are strictly read-only. The pipeline runs listschedules to analyze coverage, but it cannot overwrite shifts. You build chains to recommend changes, not enforce them.

Q: How do I verify the connection?

Run getaccountcheck as your first node. A failed check halts the execution before wasting tokens on empty data requests.

Give your LangChain agents direct access to Assembled workforce schedules and contact forecasts.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Assembled MCP to LangChain

Create your Vinkius account to connect Assembled 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 Assembled with LangChain

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain Workforce Data with the Assembled MCP Server

ReAct agents need raw data to make routing decisions. You connect this endpoint, and your setup immediately reads live coverage via `list_agent_states`. Drops in minimum staffing get caught by your pipeline before tickets pile up. LangGraph nodes handle the logic while we handle the connection. Calling `list_schedules` feeds directly into your staffing models without writing custom API wrappers. Tracing in LangSmith shows exactly how long the fetch took.

Forecast-Driven Agent Pipelines

Hardcoding contact volume assumptions breaks the moment traffic spikes. Your chains pull real numbers using `list_forecasts` via the MCP standard to determine how many agents should be online. The system evaluates that volume against open channels from `list_queues`. Feeding these two datasets into a custom prompt forces your agent to calculate staffing gaps. It outputs a specific recommendation instead of a generic warning. Your pipeline stops guessing and starts reacting to actual mathematical deficits.

Map Teams to Complex Workflows

Multi-step reasoning requires knowing who works where, which this MCP integration handles. Executing `list_teams` grabs your entire organizational structure in one shot. The chain then maps specific support requests to the correct group. Finding the right person involves checking `list_users` against current availability. LangChain grabs the roster, cross-references the active state, and passes the specific user ID to your next node. This delivers precise routing built entirely on live directory data.

Setup guide

Set up Assembled 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 Assembled 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({
    "assembled-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 Assembled 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 Assembled. 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 Assembled 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 Assembled MCP in LangChain

Install `langchain-mcp-adapters` and `langgraph`. Pass the Vinkius endpoint URL into `MultiServerMCPClient`. Your code reads the tools automatically through `client.get_tools()`.

These tools are strictly read-only. The pipeline runs `list_schedules` to analyze coverage, but it cannot overwrite shifts. You build chains to recommend changes, not enforce them.

Run `get_account_check` as your first node. A failed check halts the execution before wasting tokens on empty data requests.

Tracing works out of the box. Each request to Vinkius logs latency and input arguments. You track exactly how many times your agent polled the workforce API.

Vinkius isolates the execution in a V8 sandbox. Your team rosters never hit public logs. The MCP token grants scoped access, and the ephemeral container dies after the chain 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