How to Use the Nhost MCP in OpenAI Agents SDK

Q: How do I configure the Nhost MCP Server with the OpenAI Agents SDK?

Install the package via pip install openai-agents. Initialize MCPServerStreamableHttp with your Nhost endpoint URL and pass it to your agent's mcpservers array.

Q: Can the OpenAI Agents SDK handle Nhost user sessions?

Yes. Your agent creates sessions using signinemailpassword or signinanonymous. It then maintains state by calling refreshtoken when the access token expires.

Q: How do I handle file uploads in the MCP agent loop?

Map the uploadfile tool to your agent. The server returns metadata for the processed file, which the agent can immediately log to your trace.

Connect the Nhost MCP Server directly to your OpenAI Agents SDK production system with built-in execution guardrails.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Nhost MCP to OpenAI Agents SDK

Create your Vinkius account to connect Nhost to OpenAI Agents SDK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Nhost with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Production Auth with OpenAI Agents SDK

The Nhost MCP Server exposes 15 tools to your OpenAI agents, handling user registration and session management. Your agent triggers `signup_email_password` or `signin_otp_email`, and the SDK traces the exact execution path straight to your OpenAI dashboard. You don't have to write custom wrappers for credential handling. Set up the `MCPServerStreamableHttp` context manager, and the agent auto-discovers endpoints like `refresh_token` while following your exact safety constraints.

Managed File Operations

Agents manage bucket assets using `upload_file` and `delete_file` without ever leaving the execution loop. If an agent needs to read an image, it just calls `get_file` with optional transformation parameters. Handoffs between specialized agents work perfectly here. A public-facing agent generates a secure link via `get_file_presigned_url`, then passes the session context to an internal agent for further processing.

Secure Profile Management

Elevated actions require the `NHOST_JWT` credential, which the OpenAI Agents SDK validates before execution. Your agent runs `get_user` or `change_email` only when the active session matches the required permission tier. Passing `cacheToolsList=True` in your setup drops the latency for these checks. The agent knows exactly when to call `reset_password` or `signout` without re-fetching the schema on every single turn.

Setup guide

Set up Nhost MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Nhost tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Nhost tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Nhost tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Nhost Agent",
            instructions="You have access to Nhost tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Nhost. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Nhost now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Nhost MCP in OpenAI Agents SDK

Install the package via `pip install openai-agents`. Initialize `MCPServerStreamableHttp` with your Nhost endpoint URL and pass it to your agent's `mcp_servers` array.

Yes. Your agent creates sessions using `signin_email_password` or `signin_anonymous`. It then maintains state by calling `refresh_token` when the access token expires.

The SDK intercepts every tool call before execution. If an agent attempts to run `delete_file` outside your defined safety boundaries, the guardrail blocks the request immediately.

Map the `upload_file` tool to your agent. The server returns metadata for the processed file, which the agent can immediately log to your trace.

The server processes raw credential strings during authentication. To prevent these strings from persisting in your LLM memory, you must run the agent in an isolated environment and scrub the tool arguments from your trace logs.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript