How to Use the 7shifts MCP in OpenAI Agents SDK

Q: How do I connect the 7shifts MCP Server to OpenAI Agents SDK?

Initialize MCPServerStreamableHttp with your Vinkius endpoint URL. Pass it into the Agent constructor using the mcpservers list. The SDK automatically discovers all available tools.

Write production restaurant agents that manage shifts and staff with 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 7shifts MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build Restaurant Agents with OpenAI Agents SDK

You need hard constraints when an agent modifies restaurant schedules. Connecting this MCP Server gives your agent access to `create_shift` for drafting next week's roster, while built-in guardrails validate the inputs before hitting the API. Calling `list_schedules` provides current coverage data so it never double-books your line cooks. Specialized agents handle different parts of the operation. One agent pulls profiles using `get_account_info` and hands off the data to a scheduling agent. You track every single API call through the OpenAI dashboard, meaning you know exactly why a specific shift was assigned.

Track Labor Costs and Departments

Production systems require visibility into time clock entries. Your agent fetches raw punch data via `list_time_punches` to calculate overtime before it ruins your margins. Tracing guarantees you can audit exactly which agent pulled the labor numbers on any given day. Managing organizational structures happens automatically. The agent reads `list_departments` to understand your restaurant layout and cross-references `list_roles` to ensure only certified bartenders get assigned to the bar. Guardrails stop the agent from assigning a dishwasher to a manager role.

Automate Multi-Location Webhooks

Scaling across multiple restaurants means handling complex configurations. Your setup pulls active locations with `list_locations` and configures event triggers using `list_webhooks`. This MCP Server handles the authentication while your agent manages the routing logic. Employee onboarding workflows run entirely in Python. The code creates records via `create_employee` and verifies the details by calling `get_employee`. Setting `cacheToolsList=True` keeps these operations fast by avoiding redundant tool discovery requests.

Setup guide

Set up 7shifts 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 7shifts tools at runtime.
3

Create your Agent

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

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate 7shifts 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="7shifts Agent",
            instructions="You have access to 7shifts 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 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 OpenAI Agents SDK

Initialize `MCPServerStreamableHttp` with your Vinkius endpoint URL. Pass it into the `Agent` constructor using the `mcp_servers` list. The SDK automatically discovers all available tools.

Yes. The framework reads the schema directly from the server. Set `cacheToolsList=True` to improve initialization speed in production environments.

You define strict guardrails in your Python code. Before the agent executes a destructive action like creating a shift, the SDK validates the parameters against your rules.

The framework logs the exact request and response payload. You can view the full execution trace in your OpenAI dashboard to debug why an agent selected a specific employee.

The server runs in an ephemeral V8 Isolate Sandbox on Vinkius. It processes the raw time clock data and immediately destroys the environment after the request finishes. No labor data persists on our infrastructure.

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