How to Use the 7shifts MCP in LangChain

Q: How does this MCP Server handle multiple restaurant locations in LangChain?

The agent queries listlocations to fetch all configured departments and roles. It then uses those specific IDs to filter shift lists or assign employees to the correct spot.

Get your LangChain agents managing 7shifts restaurant schedules and employee profiles without manual API calls.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect 7shifts MCP to LangChain

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build automated scheduling chains with this MCP Server

The `list_shifts` tool lets your LangChain agent pull active schedules directly into your chains. You pass this data to downstream nodes in your LangGraph state to detect coverage gaps or double-bookings. Combining this with `list_time_off` gives your pipeline the context it needs to make smart decisions. The agent checks pending requests, compares them against current shifts, and flags scheduling conflicts before they hit the floor.

Onboard restaurant staff programmatically

The `create_employee` tool registers new staff members in your system using their name and email. Your LangChain agent handles the data collection from your HR pipeline and passes it straight to the tool. Once the profile is live, the agent uses `list_locations` to find the right department and role IDs. This keeps your staff directory structured without requiring manual copy-pasting between systems.

Direct shift assignment via LangChain agent chains

The `create_shift` tool writes new schedule entries directly to 7shifts using specific employee IDs and ISO 8601 timestamps. Your agent calculates the correct coverage hours and triggers the tool to fill empty slots. By using LangSmith with this MCP Server, you trace every step of this scheduling chain to monitor latency and check exactly what parameters the agent sends. This visibility ensures your automated shift assignments remain accurate and error-free.

Setup guide

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

Install the langchain-mcp-adapters package and initialize the MCP client with your Vinkius endpoint. Call the get_tools method to fetch the tools and pass them directly to your agent constructor.

Yes, LangChain excels at this because of its chain architecture. Your agent runs a loop where it first calls `list_shifts` to check current coverage, evaluates the gaps, and then triggers `create_shift` to assign the right employee.

The agent queries `list_locations` to fetch all configured departments and roles. It then uses those specific IDs to filter shift lists or assign employees to the correct spot.

Use LangSmith tracing to monitor every tool execution. You will see the exact inputs sent to `create_employee` or `list_time_off` alongside the token usage and response latency using standard MCP tools.

Your restaurant's employee profiles, shift histories, and time-off requests stay protected inside an isolated V8 sandbox. Vinkius manages the authentication token securely, meaning your LangChain code never exposes raw API credentials to the network.

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