How to Use the AwardWallet MCP in Mastra AI

Q: How do I require approval before sharing an AwardWallet timeline in Mastra AI?

You can use Mastra's human-in-the-loop feature by setting requireToolApproval on the getusertimeline tool. The agent will pause and wait for your confirmation before exposing sensitive flight and hotel details.

Automate AwardWallet reward tracking and travel alerts with Mastra AI workflows and resilient agent pipelines.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect AwardWallet MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Resilient balance tracking with Mastra AI

The `get_user_accounts` and `get_account_details` tools pull current point balances and tier statuses from a user's AwardWallet profile. By mounting these MCP tools inside a Mastra AI workflow, you can build scheduled agents that check for balance drops and automatically trigger alerts if a user's mileage balance changes unexpectedly. If the initial API check fails due to a network glitch, Mastra's built-in retry engine automatically backs off and tries again. This keeps your reward tracking background jobs running without crashing your entire node process.

Build multi-step travel pipelines using this MCP Server

The `get_user_timeline` tool fetches a clean chronological list of a user's upcoming trips and past travels. Mastra AI lets you chain this tool with conditional branches, allowing your agent to check the timeline, detect upcoming flights, and automatically trigger check-in reminders or packing lists. Because Mastra supports human-in-the-loop approvals, you don't have to worry about an agent sending weird emails to your clients. The agent pauses before executing high-priority actions, letting you green-light the travel update first.

Automated API connection testing

The `get_account_check` tool verifies that your connection to the AwardWallet Business API is active and healthy. Running this tool within a Mastra AI system health workflow lets your background workers proactively monitor API status and notify your team if credentials expire. It's easy to set up a simple workflow that runs this check daily. If the connection fails, the agent branches to a notification step, ensuring you never miss a sync window for your users' travel data.

Setup guide

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

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

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

Yes, Mastra AI features built-in exponential backoff. If a tool like `get_account_history` fails due to rate limiting, the workflow engine automatically schedules a retry without requiring manual error-handling code.

You can use Mastra's human-in-the-loop feature by setting `requireToolApproval` on the `get_user_timeline` tool. The agent will pause and wait for your confirmation before exposing sensitive flight and hotel details.

Initialize the MCPClient with the Vinkius server URL, then spread the tools returned by `listTools()` directly into your Mastra AI agent's tool array. Your agent can then naturally decide when to call `get_user_accounts` based on user prompts.

Yes. Mastra's workflow engine lets you trigger agents on cron schedules to run tasks like pulling `get_user_itineraries` every morning, keeping your local travel databases perfectly synced.

The travel itineraries, account histories, and loyalty provider details retrieved by this MCP Server are never stored by Vinkius. Every transaction runs in an ephemeral, zero-trust sandbox, passing your API credentials securely between Mastra AI and the AwardWallet servers.

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