How to Use the airfocus MCP in Mastra AI

Build complex planning workflows with Mastra AI and the airfocus MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect airfocus MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain airfocus tasks in Mastra AI

Use `list_airfocus_workspaces` and `list_airfocus_items` to kick off your multi-step agent flow. Mastra handles the retries if the network blips. Your agent can now branch logic based on specific item scores. It makes the decision to proceed or alert an admin automatically.

Execute roadmap writes with recovery

Wrap `update_airfocus_item` in a workflow that includes exponential backoff. It ensures your data lands in the right place even if the API is under load. This prevents partial updates or data loss during long-running agent tasks. Your workspace stays consistent without manual oversight.

Inject custom field logic

Call `list_airfocus_fields` to ensure your agent understands the board structure before it writes any data. It prevents schema errors during automated runs. Your agent adapts its payload to match your team's specific field requirements. It checks the environment first, then acts.

Setup guide

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

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

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

Add our server to your Mastra agent config. You can then trigger any of the six tools as part of your step-by-step logic.

Yes, use the update tool to push scores calculated by your agent. It keeps your roadmap accurate based on your custom criteria.

You can force a human-in-the-loop check before the agent runs any write operation. It keeps you in control of your workspace.

The server plays nice with the built-in workflow engine. If a tool fails, Mastra will retry based on your defined policy.

Your roadmap entries and workspace IDs are handled via a secure token. We isolate every session so no other agents see your plan.

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

Mastra AI sdk-typescript

Start using the airfocus MCP today

We host it, we monitor it, we maintain it. You just paste one token.

Get started