Gotify MCP Server for Mastra AIGive Mastra AI instant access to 22 tools to Change Password, Create Application, Create Client, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Gotify 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 Gotify MCP Server for Mastra AI is a standout in the Communication Messaging category — giving your AI agent 22 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: {
"gotify": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Gotify Agent",
instructions:
"You help users interact with Gotify " +
"using 22 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Gotify?"
);
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 Gotify MCP Server
Connect your Gotify instance to any AI agent to streamline your notification workflows. Gotify is a self-hosted notification server, and this MCP server allows you to interact with its API using natural language.
Mastra's agent abstraction provides a clean separation between LLM logic and Gotify tool infrastructure. Connect 22 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
- Messaging — Send push notifications with custom priorities and titles, or retrieve and delete existing messages from your stream.
- Application Management — Create, list, update, or delete Gotify applications to organize your notification sources and tokens.
- Client Control — Manage clients and tokens to authorize different devices or services to receive messages.
- User Administration — (Admin only) List or create users to manage access to your private Gotify instance.
The Gotify MCP Server exposes 22 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 22 Gotify tools available for Mastra AI
When Mastra AI connects to Gotify through Vinkius, your AI agent gets direct access to every tool listed below — spanning push-notifications, self-hosted, alerts, 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.
Change password on Gotify
Change current user password
Create application on Gotify
Create a new application
Create client on Gotify
Create a new client
Create user on Gotify
Create a new user (Admin only)
Delete all messages on Gotify
Delete all messages for the authenticated client
Delete application on Gotify
Delete an application
Delete client on Gotify
Delete a client
Delete message on Gotify
Delete a specific message
Get applications on Gotify
List all applications
Get clients on Gotify
List all clients
Get current user on Gotify
Get current user details
Get health on Gotify
Get server health status
Get messages on Gotify
Requires GOTIFY_CLIENT_TOKEN. Retrieve messages
Get plugin config on Gotify
Get plugin configuration
Get plugin display on Gotify
Get plugin display info
Get plugins on Gotify
List all plugins
Get users on Gotify
List all users (Admin only)
Get version on Gotify
Get server version info
Send message on Gotify
Requires GOTIFY_APP_TOKEN. Send a message via Gotify
Update application on Gotify
Update an application
Update client on Gotify
Update a client
Update plugin config on Gotify
Update plugin configuration
Connect Gotify to Mastra AI via MCP
Follow these steps to wire Gotify 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 Gotify MCP Server
Mastra AI provides unique advantages when paired with Gotify through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Gotify 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 Gotify 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
Gotify + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Gotify MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Gotify, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Gotify as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Gotify on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Gotify tools alongside other MCP servers
Example Prompts for Gotify in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Gotify immediately.
"Send a high-priority Gotify message titled 'System Alert' saying 'Disk space is low on Server A'."
"List all my current Gotify applications and their descriptions."
"Get the last 5 messages from my Gotify server."
Troubleshooting Gotify MCP Server with Mastra AI
Common issues when connecting Gotify to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpGotify + Mastra AI FAQ
Common questions about integrating Gotify 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 →
Automate Reddit interactions via AI — search subreddits, list hot posts, and retrieve comment threads directly.
ElevenLabs Alternative
34 toolsGenerate lifelike speech, clone voices, and create sound effects using ElevenLabs' industry-leading AI audio technology.
Todoist Alternative
10 toolsManage your Todoist tasks and projects — audit productivity via AI.
String Operations Engine
3 toolsEquip your AI with deterministic text manipulation. Instantly format casings (camelCase, PascalCase, slugify), truncate safely, and count exact characters local.