How to Use the Guestmeter MCP in OpenAI Agents SDK

Q: Can my OpenAI Agents SDK assistant trigger SMS surveys automatically using Guestmeter?

Yes, the agent calls the sendsurvey tool with a phone number parameter. It handles the API call to Guestmeter instantly. You don't have to write custom integration code for SMS delivery.

Q: How does Guestmeter work with the guardrails in the OpenAI Agents SDK?

The SDK validates the arguments for tools like sendsurvey before execution. If an agent tries to send a survey without a valid email or phone number, the guardrails block the call. This prevents bad data from hitting your API.

Q: What is the fastest way to pull unhappy guest data?

Have your agent run listdetractors to get a list of guests who rated their stay 1 to 6. This returns the exact guest IDs that need immediate recovery efforts.

Trigger surveys and handle guest complaints automatically inside your OpenAI Agents SDK MCP workflows.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Guestmeter MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stop bad reviews with OpenAI Agents SDK

The Guestmeter MCP Server provides tools to intercept guest complaints before they hit public forums. Your agent runs `list_detractors` to pull guests who left low ratings between 1 and 6. This gets you a direct list of unhappy people who need immediate attention. Once identified, the agent uses `get_guest_details` to pull their specific contact info. You don't have to manually dig through databases to find who is mad. The agent handles the lookup and flags the front desk to call them right away.

Automate post-stay outreach loops

The Guestmeter MCP Server automates guest surveys so you do not have to send them manually. The `send_survey` tool fires off a feedback request via SMS or email using just a phone number or email address. If you want to check who already got a request, the agent runs `list_guest_feedback`. This returns the status of every guest survey so you never double-survey the same room. You keep your communication clean and avoid annoying your guests.

Track sentiment trends using this MCP Server

This MCP Server exposes `list_recent_feedback` to pull the last 50 entries directly into your agent's context. Your agent analyzes these responses to spot recurring operational issues like cold breakfast or slow check-ins. To balance the negative data, `list_promoters` filters out everyone who gave a 9 or 10 rating. You get a clear picture of what is working well. The agent then routes these happy guests to your marketing team for testimonial collection.

Setup guide

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

Create your Agent

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

Run the agent

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

You initialize MCPServerStreamableHttp with the Vinkius endpoint URL. Pass this server object into your Agent constructor's mcp_servers list. The SDK automatically discovers all six feedback tools at startup.

Yes, the agent calls the `send_survey` tool with a phone number parameter. It handles the API call to Guestmeter instantly. You don't have to write custom integration code for SMS delivery.

The SDK validates the arguments for tools like `send_survey` before execution. If an agent tries to send a survey without a valid email or phone number, the guardrails block the call. This prevents bad data from hitting your API.

Have your agent run `list_detractors` to get a list of guests who rated their stay 1 to 6. This returns the exact guest IDs that need immediate recovery efforts.

This server processes guest contact details, phone numbers, and email addresses inside an ephemeral V8 sandbox. No personal guest data is stored on Vinkius servers. Every request runs through a secure, single-token connection that you control.

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