Nhost MCP Server for Mastra AIGive Mastra AI instant access to 15 tools to Change Email, Delete File, Get File, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Nhost 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 Nhost MCP Server for Mastra AI is a standout in the Developer Tools category — giving your AI agent 15 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: {
"nhost": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Nhost Agent",
instructions:
"You help users interact with Nhost " +
"using 15 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Nhost?"
);
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 Nhost MCP Server
Connect your Nhost project to any AI agent to manage your backend services through natural language. This server provides a comprehensive interface for Nhost's Authentication and Storage services.
Mastra's agent abstraction provides a clean separation between LLM logic and Nhost tool infrastructure. Connect 15 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
- Authentication Flows — Sign in users via email/password, OTP, magic links, or anonymous sessions using
signin_email_password,signin_otp_email, andsignin_passwordless_email. - User Management — Register new accounts with
signup_email_password, retrieve profiles withget_user, and handle password resets or email changes. - Session Control — Refresh access tokens and securely sign out users from single or all devices using
refresh_tokenandsignout. - Cloud Storage — Upload files directly to your Nhost buckets using the
upload_filetool, supporting both text and base64 content.
The Nhost MCP Server exposes 15 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 15 Nhost tools available for Mastra AI
When Mastra AI connects to Nhost through Vinkius, your AI agent gets direct access to every tool listed below — spanning authentication, backend-as-a-service, cloud-storage, 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 email on Nhost
Requires elevated NHOST_JWT credential. Request to change the authenticated user email
Delete file on Nhost
Permanently delete a file
Get file on Nhost
Supports optional image transformation parameters. Download the complete file content
Get file presigned url on Nhost
Retrieve a presigned URL for a file
Get user on Nhost
Requires NHOST_JWT credential. Retrieve the authenticated user profile information
Refresh token on Nhost
Generate a new JWT access token using a valid refresh token
Reset password on Nhost
Request a password reset email
Signin anonymous on Nhost
Create an anonymous user session
Signin email password on Nhost
Authenticate a user with email and password
Signin otp email on Nhost
Initiate email-based one-time password authentication
Signin passwordless email on Nhost
Initiate passwordless authentication by sending a magic link
Signout on Nhost
Invalidate refresh tokens and end the session
Signup email password on Nhost
Register a new user account
Signup otp email on Nhost
Register a new user account using email OTP
Upload file on Nhost
Returns metadata for the processed file. Upload a file to a bucket
Connect Nhost to Mastra AI via MCP
Follow these steps to wire Nhost 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 Nhost MCP Server
Mastra AI provides unique advantages when paired with Nhost through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Nhost 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 Nhost 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
Nhost + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Nhost MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Nhost, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Nhost as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Nhost on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Nhost tools alongside other MCP servers
Example Prompts for Nhost in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Nhost immediately.
"Sign in user dev@example.com with password 'securePass123'."
"Show me the profile details for the current authenticated user."
"Upload a file named 'config.json' with content '{"theme": "dark"}'."
Troubleshooting Nhost MCP Server with Mastra AI
Common issues when connecting Nhost to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpNhost + Mastra AI FAQ
Common questions about integrating Nhost 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 →
Brankas
8 toolsManage open finance operations via Brankas API — process direct payments, send disbursements, and access bank statements from any AI agent.
Netdata
10 toolsMonitor real-time infrastructure metrics, analyze system performance, and track active alerts across your nodes and Netdata Cloud spaces.
Xiaomi Push Service / 小米推送
6 toolsXiaomi's essential device push platform — send notifications to MIUI and Global devices via AI.
Nuvemshop
24 toolsManage your Nuvemshop e-commerce via API — list products, orders, customers, coupons, and webhooks directly from any AI agent.