How to Use the Avaza MCP in Mastra AI

Connect Avaza to Mastra AI to build resilient, auto-retry project workflows.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Avaza MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Avaza tasks in Mastra AI

Link `create_task` and `update_task` to your Mastra agent logic. When a project hits a snag, the agent executes the update automatically. This setup allows for conditional workflows where task status changes trigger downstream events. It keeps your project board synced with your actual team progress.

Manage Avaza contacts with Mastra AI

Use `list_contacts` to feed your agent the latest customer information. Your workflow engine then routes work based on these specific contact details. It removes manual lookups. The agent knows exactly who to assign work to based on the data pulled directly from your CRM.

Audit Avaza timesheets using Mastra AI

Run `list_timesheets` through your agent to flag anomalies or missing entries. The workflow engine can notify you if a project exceeds its estimated hours. This gives your team a clear view of burn rates. You catch budget issues before they become actual headaches.

Setup guide

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

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

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

You add the server to your Mastra configuration file. The agent then treats Avaza tools as native actions, allowing for complex, multi-step project management workflows.

Absolutely, you can define a workflow that detects a change in project status and automatically calls the update tool. This keeps your Avaza data current without human intervention.

Mastra handles retries with backoff settings for any failed Avaza tool call. If the connection drops or the API rate limits, the agent waits and tries again automatically.

You use the endpoint token provided by Vinkius. This ensures that only your authorized Mastra agents can interact with your Avaza workspace.

Data is processed only within the ephemeral runtime of the agent. The server doesn't store your Avaza contact lists, ensuring your firm's private information never persists beyond the task execution.

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