Prometheus MCP Server for Mastra AIGive Mastra AI instant access to 14 tools to Clean Tombstones, Create Snapshot, Delete Series, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Prometheus through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The Prometheus MCP Server for Mastra AI is a standout in the Loved By Devs category — giving your AI agent 14 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"prometheus": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Prometheus Agent",
instructions:
"You help users interact with Prometheus " +
"using 14 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Prometheus?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Prometheus MCP Server
Connect your Prometheus instance to any AI agent and transform your observability data into actionable insights through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and Prometheus tool infrastructure. Connect 14 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Instant & Range Queries — Evaluate complex PromQL expressions for real-time status or historical trends over specific time windows.
- Metric Discovery — Find time series matching specific label selectors and explore available labels and their values across your environment.
- Metadata Inspection — Retrieve detailed metadata about metrics scraped from targets to understand units, types, and help text.
- Admin Operations — Create data snapshots, delete specific series, and clean tombstones (requires admin API enabled).
- System Status — Inspect your Prometheus configuration, flags, and runtime information to ensure your monitoring stack is healthy.
The Prometheus MCP Server exposes 14 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 14 Prometheus tools available for Mastra AI
When Mastra AI connects to Prometheus through Vinkius, your AI agent gets direct access to every tool listed below — spanning prometheus, promql, metrics, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Clean tombstones on Prometheus
enable-admin-api to be enabled. Remove deleted data from disk
Create snapshot on Prometheus
enable-admin-api to be enabled on the Prometheus server. Create a snapshot of all current data
Delete series on Prometheus
enable-admin-api to be enabled. Delete data for a selection of series in a time range
Find series on Prometheus
Find time series matching label selectors
Get label values on Prometheus
Get all values for a specific label
Get labels on Prometheus
Get a list of all label names
Get metadata on Prometheus
Get metadata about metrics scraped from targets
Get status buildinfo on Prometheus
Get Prometheus build information
Get status config on Prometheus
Get the currently loaded Prometheus configuration (YAML)
Get status flags on Prometheus
Get configured Prometheus flag values
Get status runtimeinfo on Prometheus
Get Prometheus runtime information
Get status tsdb on Prometheus
Get TSDB cardinality statistics
Query on Prometheus
Evaluate a PromQL expression at a single point in time
Query range on Prometheus
Evaluate a PromQL expression over a range of time
Connect Prometheus to Mastra AI via MCP
Follow these steps to wire Prometheus into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Prometheus MCP Server
Mastra AI provides unique advantages when paired with Prometheus through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Prometheus without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Prometheus tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Prometheus + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Prometheus MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Prometheus, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Prometheus as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Prometheus on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Prometheus tools alongside other MCP servers
Example Prompts for Prometheus in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Prometheus immediately.
"Run an instant query for 'up' to see which targets are currently reachable."
"Show me the average CPU usage for the last 30 minutes using query_range."
"What is the metadata for the metric 'http_requests_total'?"
Troubleshooting Prometheus MCP Server with Mastra AI
Common issues when connecting Prometheus to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpPrometheus + Mastra AI FAQ
Common questions about integrating Prometheus MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Omni BI Intelligence
10 toolsInteract with Omni BI dashboards, models, and data exports — run queries and track metrics directly from your AI agent.
Magento (Adobe Commerce)
10 toolsManage e-commerce via Magento (Adobe Commerce) — search products, track orders, and audit customer data.
SurrealDB
16 toolsManage SurrealDB instances — execute SurrealQL, query tables, and manage records directly from any AI agent.
Figma Alternative
16 toolsAccess Figma design files, comments, components and images via API — inspect nodes, render exports and track version history from any AI agent.