How to Use the Armano MCP in Mastra AI

Q: How do I add Armano tools to Mastra AI?

Install @mastra/mcp and instantiate a new MCPClient. Pass your Vinkius URL in the servers config block. Call listTools() and spread them into your Agent setup.

Q: Can Mastra AI require human approval for Armano time entries?

Yes. Set requireToolApproval on the createtimeentry tool. The workflow will pause and wait for a manager to hit approve before committing the record to the database.

Q: How do I filter Armano projects in a Mastra AI MCP workflow?

Pass a specific date range to listtimeentries or instruct the agent to parse the output of listprojects. The LLM handles the filtering based on your workflow's conditional branching rules.

Wire up automated HR workflows in Mastra AI that handle time tracking failures gracefully.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Armano MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build resilient workflows with Mastra AI

Background jobs fail. APIs timeout. When you build an HR sync process, you need a framework that catches errors instead of crashing. This MCP Server hooks into your workflow engine to make sure tasks actually finish. If a call to `check_armano_status` drops, the system automatically retries with exponential backoff. You configure the logic once. The agent figures out how to keep the pipeline moving without paging you at 3 AM.

Automate complex time entry logic

Sometimes people forget to log their hours until Friday afternoon. You can write a workflow that checks for missing logs and nudges them automatically. The logic runs in the background on your schedule. Your agent runs `list_employees` to get the team roster, then loops through `list_time_entries` for the week. If it spots a gap, it creates a draft using `create_time_entry` and asks the user for approval via a Slack integration.

Sync project and department data

Keeping your internal tools updated with the latest org chart is a massive headache. Stop writing custom cron jobs for this. Let an intelligent agent handle the data mapping between your systems. The workflow triggers `list_departments` and `list_projects` every night. It compares the output against your local database. When it finds a discrepancy, it pulls the specific record with `get_project` and updates your system.

Setup guide

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

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

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

Install `@mastra/mcp` and instantiate a new `MCPClient`. Pass your Vinkius URL in the servers config block. Call `listTools()` and spread them into your Agent setup.

Yes. Set `requireToolApproval` on the `create_time_entry` tool. The workflow will pause and wait for a manager to hit approve before committing the record to the database.

The framework catches the error and applies its built-in retry logic. It will back off exponentially and try the request again before marking the workflow step as failed.

Pass a specific date range to `list_time_entries` or instruct the agent to parse the output of `list_projects`. The LLM handles the filtering based on your workflow's conditional branching rules.

Every request runs through a zero-trust architecture. When your workflow pulls sensitive employee details or department lists, the proxy authenticates the single call and tears down the environment immediately. No lingering access.

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