How to Use the AgentOps (Agent Telemetry and Monitoring) MCP in Mastra AI
Monitor complex Mastra AI workflows and conditional branches with live AgentOps telemetry.
Works with every AI agent you already use
…and any MCP-compatible client
Connect AgentOps (Agent Telemetry and Monitoring) MCP to Mastra AI
Create your Vinkius account to connect AgentOps (Agent Telemetry and Monitoring) 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.
Track Mastra AI workflow traces
The `get_trace` tool retrieves the complete execution path of your Mastra AI workflow steps. When a multi-step workflow branches or retries, this MCP Server tool exposes which path the engine selected. This integration allows your workflow transitions to automatically query their own execution history. If a step fails, the workflow checks the trace to decide whether to trigger an alternative route or escalate to an admin.
Debug failed Mastra AI steps via MCP Server
The `get_span` tool isolates individual step errors inside your Mastra AI workflow engine. You call this tool inside your workflow catch blocks to inspect the exact input and output of the failed step. Instead of guessing why a retry failed, your workflow uses the returned span data to adjust its next attempt. This makes your automated recovery loops smarter and prevents infinite retry cycles.
Audit agent performance programmatically
The `get_project` tool fetches high-level performance aggregates directly into your Mastra AI workflow. This lets your system run scheduled checks on agent success rates and trigger automated deployments if performance drops. You can write a Mastra workflow that runs every hour, checks these project metrics, and posts a Slack alert if the error rate exceeds your threshold.
Set up AgentOps (Agent Telemetry and Monitoring) MCP in Mastra AI
Prerequisites
- Node.js 18+ and a TypeScript project
-
@mastra/mcp+@mastra/corepackages - Active Vinkius subscription with a valid endpoint token
- 1
Install dependencies
Run
npm install @mastra/mcp @mastra/coreplus your preferred model provider (e.g.@ai-sdk/openai). - 2
Configure the MCPClient
Create an
MCPClientwith your Vinkius endpoint as aURLobject. 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'stoolsobject. All AgentOps (Agent Telemetry and Monitoring) tools become native Mastra tools. - 4
Run with any model
Swap
openai("gpt-4o")for any AI SDK-compatible provider. Callagent.generate()and the agent routes tool calls through MCP automatically.
import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";
const mcpClient = new MCPClient({
id: "agentops-agent-telemetry-and-monitoring-mcp-client",
servers: {
"agentops-agent-telemetry-and-monitoring-mcp": {
url: new URL(
"https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
),
},
},
});
const agent = new Agent({
name: "AgentOps (Agent Telemetry and Monitoring) Agent",
model: openai("gpt-4o"),
instructions: "You have access to AgentOps (Agent Telemetry and Monitoring) tools.",
tools: {
...(await mcpClient.listTools()),
},
});
const result = await agent.generate(
"List recent AgentOps (Agent Telemetry and Monitoring) transactions"
);
console.log(result.text); Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by AgentOps. 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.
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 AgentOps (Agent Telemetry and Monitoring) MCP in Mastra AI
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the AgentOps (Agent Telemetry and Monitoring) MCP today
We host it, we monitor it, we maintain it. You just paste one token.