How to Use the Gatus (Health Dashboard) MCP in Mastra AI

Q: How do I integrate Gatus (Health Dashboard) with Mastra AI?

Install @mastra/mcp@latest. Initialize an MCPClient with your Vinkius URL. Call listTools() and spread the Gatus tools directly into your agent's configuration.

Q: How do I require approval for actions based on Gatus (Health Dashboard) data in Mastra AI?

Use the requireToolApproval flag in your configuration. The agent will fetch the data, pause, and wait for a human operator to sign off before continuing.

Q: Does the workflow engine support conditional steps based on metrics?

Definitely. You pull the output from getendpointstats and write a branching condition. If latency exceeds 500ms, route to the escalation branch; otherwise, exit.

Build automated incident response workflows with Mastra AI and live Gatus monitoring data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gatus (Health Dashboard) MCP to Mastra AI

Create your Vinkius account to connect Gatus (Health Dashboard) 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 Gatus (Health Dashboard) with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Branching logic for Mastra AI workflows

The `list_endpoints` tool feeds your workflow engine the current status of all monitored targets. If Mastra detects a downed service, it triggers conditional branches to investigate further. The agent automatically routes the workflow to call `get_endpoint_health` for the specific failing target. You configure exponential backoff retries if the network drops the connection during the check.

Automate performance degradation checks

Use `get_endpoint_stats` to pull latency metrics into your automated pipelines. When response times spike above your defined threshold, the workflow initiates the escalation path. You don't need to write manual polling scripts. The agent executes the tool, evaluates the numbers against historical data, and decides whether to page an engineer or wait for the next cycle.

Human-in-the-loop incident routing

The `get_metrics` tool dumps raw Prometheus-compatible telemetry for deep analysis. Before Mastra executes a destructive action based on this data, you can require human approval. The agent pauses the workflow and sends the Gatus metrics to a Slack channel. Once an operator approves the step, the workflow resumes and executes the remediation script.

Setup guide

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

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

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

Install `@mastra/mcp@latest`. Initialize an `MCPClient` with your Vinkius URL. Call `listTools()` and spread the Gatus tools directly into your agent's configuration.

Yes. The framework handles transient failures automatically. If `get_endpoint_health` times out, the agent retries the call using exponential backoff before failing the workflow.

Use the `requireToolApproval` flag in your configuration. The agent will fetch the data, pause, and wait for a human operator to sign off before continuing.

Definitely. You pull the output from `get_endpoint_stats` and write a branching condition. If latency exceeds 500ms, route to the escalation branch; otherwise, exit.

This MCP Server only processes endpoint response times and status codes. Vinkius runs the connection through a zero-trust, ephemeral sandbox that drops all state the moment the workflow finishes.

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