How to Use the Guesty MCP in Mastra AI

Q: Is my Guesty accounting stats data safe from exposure when using Mastra AI?

All financial records retrieved via getaccountingstats stay within your private execution context. Vinkius secures the transport layer, ensuring sensitive revenue data is never exposed to third parties.

Automate complex hospitality workflows using Mastra AI and Guesty tools.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Guesty MCP to Mastra AI

Create your Vinkius account to connect Guesty to Mastra AI 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 Guesty with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build resilient operations with Mastra AI and this MCP Server.

Setting up cleaning schedules shouldn't break when a third-party API hiccups. This integration lets your agent call `list_tasks` and automatically schedules follow-ups with built-in retries. If the initial call fails, Mastra handles the backoff logic behind the scenes. Your operational workflows keep running, ensuring check-out cleanings are never missed.

Run conditional checks on incoming reservations.

Trigger automated workflows the moment a new booking arrives. Your agent pulls details with `get_reservation` and checks them against your occupancy rules. If a conflict arises, the workflow branches to notify your team or update the calendar. This prevents manual errors and double bookings before they affect your guests.

Keep your guest databases updated automatically.

Managing guest details across multiple channels gets messy fast. Your agent uses `list_guests` to match incoming names with existing profiles in your system. This automated mapping ensures your communication history stays accurate. Manual database cleanup becomes a thing of the past.

Setup guide

Set up Guesty MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Guesty tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "guesty-mcp-client",
  servers: {
    "guesty-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Guesty Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Guesty tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Guesty transactions"
);
console.log(result.text);

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 Guesty. 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 Guesty 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 Guesty MCP in Mastra AI

Instantiate the client with your Vinkius URL and list the tools. Then, spread those tools directly into your agent configuration block.

Yes, you can use the manual approval feature in your workflow definition. This stops the agent before it executes any critical MCP action, letting you review the changes first.

The framework uses built-in exponential backoff to retry failed calls to endpoints like `get_calendar`. This keeps your automation running even during high-traffic periods.

Deploy your completed project to any cloud provider with a single command. The MCP setup runs anywhere Node.js is supported.

All financial records retrieved via `get_accounting_stats` stay within your private execution context. Vinkius secures the transport layer, ensuring sensitive revenue data is never exposed to third parties.

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