How to Use the FareHarbor MCP in Mastra AI

Q: Does Mastra AI support human approval for FareHarbor bookings?

Yes, you can require manual approval before executing createbooking. Mastra pauses the workflow, alerts your team, and completes the reservation once approved.

Q: How do I handle failed FareHarbor payments in Mastra AI?

You configure a conditional branch in your workflow. If createbooking fails due to payment issues, the agent automatically retries with an alternative method or alerts the customer.

Build resilient, multi-step tour booking workflows that auto-retry failed FareHarbor API calls using Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect FareHarbor MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated retry logic for tour bookings

Executing `create_booking` through Mastra's workflow engine ensures your booking pipelines survive API drops and network hiccups. By registering this MCP Server with your Mastra AI agent, you get automatic retries with exponential backoff for every booking attempt. If a booking attempt drops mid-transit, Mastra holds the state and retries the endpoint. This prevents orphaned payments where the customer is charged but the tour operator never receives the booking.

Multi-step availability checks in Mastra AI

Running `get_availability` immediately before payment execution prevents double-bookings during high-volume tour slots. This setup uses a workflow that verifies the slot is still active before executing the final checkout. If the slot filled up during the user's session, Mastra AI branches the workflow to call `list_availabilities_by_date` and suggest alternative times. Your application handles the fallback without crashing.

Dynamic operator routing with booking tools

Querying `list_companies` via MCP lets Mastra AI identify which tour operator owns an activity before routing the transaction. Managing multiple tour companies requires precise routing, and this tool eliminates manual mapping. Once the correct company is identified, the agent pulls its specific catalog via `list_items`. This ensures bookings always route to the correct affiliate account without hardcoded configuration files.

Setup guide

Set up FareHarbor 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 FareHarbor 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: "fareharbor-mcp-client",
  servers: {
    "fareharbor-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent FareHarbor 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 FareHarbor. 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 FareHarbor 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 FareHarbor MCP in Mastra AI

Yes, you can require manual approval before executing `create_booking`. Mastra pauses the workflow, alerts your team, and completes the reservation once approved.

You configure a conditional branch in your workflow. If `create_booking` fails due to payment issues, the agent automatically retries with an alternative method or alerts the customer.

Yes, you can schedule background syncs. This server allows Mastra to query `list_items` and `list_lodgings` periodically to keep your local database updated.

Instantiate the client using the server's Vinkius endpoint URL. Pass the tools directly into your agent's configuration to expose all booking actions.

Your API keys and affiliate credentials stay securely stored in your environment. The MCP connection runs through a zero-trust sandbox, preventing raw credentials from leaking into agent logs.

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