Nhost MCP Server for OpenAI Agents SDKGive OpenAI Agents SDK instant access to 15 tools to Change Email, Delete File, Get File, and more
The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect Nhost through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.
Ask AI about this MCP Server for OpenAI Agents SDK
The Nhost MCP Server for OpenAI Agents SDK 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
import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
async with MCPServerStreamableHttp(
url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
) as mcp_server:
agent = Agent(
name="Nhost Assistant",
instructions=(
"You help users interact with Nhost. "
"You have access to 15 tools."
),
mcp_servers=[mcp_server],
)
result = await Runner.run(
agent, "List all available tools from Nhost"
)
print(result.final_output)
asyncio.run(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.
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.
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 OpenAI Agents SDK 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 OpenAI Agents SDK
When OpenAI Agents SDK 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 OpenAI Agents SDK via MCP
Follow these steps to wire Nhost into OpenAI Agents SDK. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install the SDK
pip install openai-agents in your Python environmentReplace the token
[YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.comRun the script
python agent.pyExplore tools
Why Use OpenAI Agents SDK with the Nhost MCP Server
OpenAI Agents SDK provides unique advantages when paired with Nhost through the Model Context Protocol.
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 + OpenAI Agents SDK Use Cases
Practical scenarios where OpenAI Agents SDK combined with the Nhost MCP Server delivers measurable value.
Automated workflows: build agents that query Nhost, process the data, and trigger follow-up actions autonomously
Multi-agent orchestration: create specialist agents. one queries Nhost, another analyzes results, a third generates reports
Data enrichment pipelines: stream data through Nhost tools and transform it with OpenAI models in a single async loop
Customer support bots: agents query Nhost to resolve tickets, look up records, and update statuses without human intervention
Example Prompts for Nhost in OpenAI Agents SDK
Ready-to-use prompts you can give your OpenAI Agents SDK 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 OpenAI Agents SDK
Common issues when connecting Nhost to OpenAI Agents SDK through Vinkius, and how to resolve them.
MCPServerStreamableHttp not found
pip install --upgrade openai-agentsAgent not calling tools
Nhost + OpenAI Agents SDK FAQ
Common questions about integrating Nhost MCP Server with OpenAI Agents SDK.
How does the OpenAI Agents SDK connect to MCP?
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?
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?
Explore More MCP Servers
View all →
Dutchie POS
10 toolsEquip your AI agent to manage cannabis retail products, track inventory, and monitor orders via the Dutchie POS API.

Dropbox Paper
12 toolsManage collaborative docs via Dropbox Paper — create documents, search content, handle shared links, and move files directly from any AI agent.

Salesforce Sales Cloud
10 toolsManage leads, opportunities, accounts, contacts, and your entire sales pipeline through natural conversation with your Salesforce CRM.

Clover
10 toolsManage orders, payments, inventory, customers, employees, and discounts for your Clover POS through natural conversation.
