How to Use the Axiom MCP in Mastra AI

Q: How do I add Axiom tools to a Mastra AI agent?

Initialize the MCP client with new MCPClient pointing to your Vinkius URL. Then, call mcpClient.listTools() and spread them directly into your agent's tools configuration array.

Q: Does Mastra AI support human approval for dangerous actions?

You can use the requireToolApproval option in Mastra to pause workflows before destructive actions. This prevents the agent from running deletedataset or deletemonitor without a developer's explicit sign-off.

Automate log analysis and incident response by linking Axiom to Mastra AI workflows with automatic retries.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Axiom MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Self-healing telemetry pipelines

The `ingest_data` tool lets Mastra AI agents pipe raw system events directly into your logging buckets during automated workflow runs. If a high-volume batch fails, the Mastra workflow engine automatically retries with exponential backoff to prevent data gaps. You can set up conditional branches that monitor ingestion health. If the workflow detects an anomaly, it calls `create_annotation` to mark the exact timestamp on your dashboard, keeping your team updated without manual intervention.

Automated incident response via MCP Server

The `run_query` tool allows Mastra AI agents to execute complex APL queries when system health checks fail. The framework analyzes the returned log entries to pinpoint the root cause of an outage automatically. Once the agent identifies the issue, it triggers `create_notifier` or `update_monitor` to adjust alerting thresholds dynamically. This creates a closed-loop system where your observability setup adapts to real-time production traffic.

Declarative dashboard management

The `create_dashboard` tool gives your Mastra agents the power to build custom visualization layouts during deployment pipelines. When a new service goes live, the agent automatically structures a monitoring workspace. Using `list_dashboards` and `update_dashboard`, the workflow compares existing environments and updates outdated charts. You don't have to manually click through a UI to ensure your staging and production views match.

Setup guide

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

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

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

Initialize the MCP client with `new MCPClient` pointing to your Vinkius URL. Then, call `mcpClient.listTools()` and spread them directly into your agent's tools configuration array.

Yes, Mastra's workflow engine handles transient network errors automatically when running `run_query`. It uses exponential backoff to retry the APL query before throwing an error.

You can use the `requireToolApproval` option in Mastra to pause workflows before destructive actions. This prevents the agent from running `delete_dataset` or `delete_monitor` without a developer's explicit sign-off.

The framework auto-detects the transport protocol. It connects directly to Vinkius over SSE or Streamable HTTP without requiring manual network configuration on your end.

Mastra executes tools locally or inside isolated cloud environments while Vinkius secures your MCP connection. Your raw log payloads, monitor configurations, and query outputs are never stored or inspected by third parties.

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