How to Use the Mews MCP in OpenAI Agents SDK

Q: How do agent handoffs work with this MCP integration?

You can design one agent to search guests using searchguests and then hand off to a billing agent. The billing agent then uses listpayments to check outstanding balances.

Connect your Mews property management system directly to your OpenAI Agents SDK production workflows.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mews MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Direct Room and Reservation Auditing

`get_reservations` pulls live booking lists directly into your Python runtime to check who is checking in today. Your agent can immediately call `get_reservation` to pull down specific check-in times and room requirements. No custom API wrappers needed. This setup lets your agent cross-reference incoming guest requests against actual availability. By using the OpenAI Agents SDK, you can route reservation updates to specialized agents that handle guest communication and internal housekeeping tasks.

Automated Housekeeping and Service Workflows

`list_rooms` retrieves current room status data so your agent can flag which spaces need immediate cleaning. This tool works alongside `list_services` to verify that requested amenities are ready before a guest arrives at the desk. Connecting this MCP Server to your agent pipeline means room statuses update in real time. If a room is marked clean, the agent can trigger an automated SMS to the guest via your custom communication handoffs.

OpenAI Agents SDK Guardrails for Guest Billing

`list_bills` fetches complete financial histories for any checked-in guest to prevent billing errors. The agent uses `list_payments` to check payment settlement statuses before authorizing room key handovers. Because you are running the OpenAI Agents SDK, you can set strict validation guardrails around these financial tools. The agent cannot settle a bill or pull rate details from `list_rates` without passing your predefined safety checks first.

Setup guide

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

Create your Agent

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

Run the agent

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

Instantiate MCPServerStreamableHttp pointing to your Vinkius endpoint and pass it to the Agent constructor. The SDK automatically discovers all 12 tools, including `get_guest` and `get_reservations`, with zero manual configuration.

Yes, you configure this at the agent definition level in Python. You can restrict a specific agent to only run `list_rooms` and `list_services` while keeping billing tools restricted to your finance agent.

The SDK manages agent execution loops, but you should set cacheToolsList=True to avoid redundant schema requests. For heavy operations like `search_guests`, implement standard backoff handlers in your Python runtime.

You can design one agent to search guests using `search_guests` and then hand off to a billing agent. The billing agent then uses `list_payments` to check outstanding balances.

All guest profiles, billing records, and reservation details remain within your secure V8 isolate sandbox on Vinkius. The OpenAI Agents SDK communicates over a secure, authenticated HTTPS transport, ensuring no raw guest data is exposed to public networks.

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