Compatible with every major AI agent and IDE
What is the 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.
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.
How it works
- Subscribe to this server
- Provide your Nhost Auth and Storage URLs from your project dashboard
- Start managing users and files from Claude, Cursor, or any MCP client
Who is this for?
- Full-stack Developers — manage user sessions and test auth flows directly from the IDE without switching to the browser.
- DevOps Engineers — automate user provisioning and file management tasks through simple conversation.
- Support Teams — quickly verify user profile information and account status to resolve customer issues faster.
Built-in capabilities (15)
Requires elevated NHOST_JWT credential. Request to change the authenticated user email
Permanently delete a file
Supports optional image transformation parameters. Download the complete file content
Retrieve a presigned URL for a file
Requires NHOST_JWT credential. Retrieve the authenticated user profile information
Generate a new JWT access token using a valid refresh token
Request a password reset email
Create an anonymous user session
Authenticate a user with email and password
Initiate email-based one-time password authentication
Initiate passwordless authentication by sending a magic link
Invalidate refresh tokens and end the session
Register a new user account
Register a new user account using email OTP
Returns metadata for the processed file. Upload a file to a bucket
Why Mastra AI?
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.
- —
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 in Mastra AI
Nhost and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect Nhost to Mastra AI through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 4,000+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for Nhost in Mastra AI
The Nhost 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. All 15 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in Mastra AI only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.

* 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
How Vinkius secures
Nhost for Mastra AI
Every tool call from Mastra AI to the Nhost MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
How can I retrieve the profile of the currently logged-in user?
Use the get_user tool. It fetches the authenticated user's profile information, including their ID and metadata, provided a valid JWT is configured.
Is it possible to store documents or images using this server?
Yes. The upload_file action allows you to send raw text or base64 content along with a filename directly to your Nhost Storage bucket.
Can I initiate a login without requiring a password?
Absolutely. Use the signin_passwordless_email tool to send a magic link to a user's email address for a seamless passwordless authentication experience.
How does Mastra AI connect to MCP servers?
Create an 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?
Yes. Pass multiple MCP clients to the agent constructor. Mastra merges all tool schemas and the agent can call any tool from any server.
Does Mastra support workflow orchestration?
Yes. Mastra has a built-in workflow engine that lets you chain MCP tool calls with branching logic, error handling, and parallel execution.
createMCPClient not exported
Install: npm install @mastra/mcp
Explore More MCP Servers
View all →
Nifty (All-in-One Project Management)
10 toolsManage projects via Nifty — create tasks, track sprint milestones, and audit project portfolios.
TrackingTime
12 toolsTrack how your team spends time across projects and clients with timesheets, reports, and budgeting tools that keep work profitable.

Unit & FX Calculator
3 toolsStop LLMs from mixing metric and imperial units or hallucinating exchange rates. Deterministic physical unit conversion and live currency rates.

UK Postbox
10 toolsManage your virtual mailbox via UK Postbox u2014 scan letters, forward mail, send correspondence, and track parcels from your AI agent.
