How to Use the Tock Reservations MCP in OpenAI Agents SDK

Q: Can I check future bookings using Tock Reservations and OpenAI Agents SDK?

Absolutely. Use the listfuturescheduledreservations tool to identify reservations scheduled for a date later than today. This function is critical for monitoring capacity weeks out.

Q: What if I need detailed info on all managed businesses with Tock Reservations and OpenAI Agents SDK?

You use the listmanagedbusinesses tool to get a roster of every venue in your account. This gives you the necessary identifiers so your agent can target specific locations for subsequent actions.

Manage reservations and track guest profiles with your 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 Tock Reservations MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

List a business's reservations.

The `list_business_reservations` tool pulls every reservation associated with a specific venue. You immediately see the dates, times, and party sizes for all bookings. This action lets your agent quickly verify if a table is open or if multiple conflicting bookings exist before confirming anything.

Check performance metrics via MCP Server.

Call `get_business_performance_metrics` to get a summary of how well a business is doing. It provides key stats needed for operations planning. Your agent uses these figures—like average bookings per week or peak hours—to recommend staffing changes or pricing adjustments.

Run a quick hospitality volume audit.

The `quick_hospitality_volume_audit` tool retrieves a high-level summary of activity. It gives you immediate counts for reservations, guests, and special events. This is perfect for initial checks when you just need to know the overall scale of operations without deep diving into every single record.

Setup guide

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

Create your Agent

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

Run the agent

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

The OpenAI Agents SDK connects to the MCP Server, allowing your agent to execute actions like listing reservations. It's a direct connection; when you call `list_business_reservations`, the data flows right into your running agent process.

Absolutely. Use the `list_future_scheduled_reservations` tool to identify reservations scheduled for a date later than today. This function is critical for monitoring capacity weeks out.

You use the `list_managed_businesses` tool to get a roster of every venue in your account. This gives you the necessary identifiers so your agent can target specific locations for subsequent actions.

This MCP Server touches business details, reservation records, guest profiles, and operational metrics. Your agent processes these structured data points when making decisions.

Yes. The connection is handled through Vinkius's zero-trust model. When your agent executes a tool, it only accesses the specific reservation or business metric requested; there’s no blanket access.

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