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 OpenAI Agents SDK?
The OpenAI Agents SDK auto-discovers all 15 tools from Nhost through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Nhost, another analyzes results, and a third generates reports, all orchestrated through Vinkius.
- —
Native MCP integration via
MCPServerSse, pass the URL and the SDK auto-discovers all tools with full type safety - —
Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure
- —
Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate
- —
First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output
Nhost in OpenAI Agents SDK
Nhost and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect Nhost to OpenAI Agents SDK 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 OpenAI Agents SDK
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 OpenAI Agents SDK 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 OpenAI Agents SDK
Every tool call from OpenAI Agents SDK 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 the OpenAI Agents SDK connect to MCP?
Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.
Can I use multiple MCP servers in one agent?
Yes. Pass a list of MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.
Does the SDK support streaming responses?
Yes. The SDK supports SSE and Streamable HTTP transports, both of which work natively with Vinkius.
MCPServerStreamableHttp not found
Ensure you have the latest version: pip install --upgrade openai-agents
Agent not calling tools
Make sure your prompt explicitly references the task the tools can help with.
Explore More MCP Servers
View all →
Evoliz Invoicing & Management
10 toolsEquip your AI agent to manage sales invoices, track CRM clients, and monitor quotes via the Evoliz API.

Pipedrive Products
8 toolsManage your product catalog, attach products to deals, and track recurring revenue subscriptions in Pipedrive.

Contrast Security
10 toolsEquip your AI with Contrast Security AppSec data to monitor applications and hunt critical vulnerabilities directly via chat.

BigCommerce
9 toolsManage your online store with product catalogs, order fulfillment, and customer data for high-volume e-commerce operations.
