Nhost MCP Server for Pydantic AIGive Pydantic AI instant access to 15 tools to Change Email, Delete File, Get File, and more
GDPR Free for SubscribersPydantic AI brings type-safe agent development to Python with first-class MCP support. Connect Nhost through Vinkius and every tool is automatically validated against Pydantic schemas. catch errors at build time, not in production.
Ask AI about this MCP Server for Pydantic AI
The Nhost MCP Server for Pydantic 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 asyncio
from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerHTTP
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
server = MCPServerHTTP(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
agent = Agent(
model="openai:gpt-4o",
mcp_servers=[server],
system_prompt=(
"You are an assistant with access to Nhost "
"(15 tools)."
),
)
result = await agent.run(
"What tools are available in Nhost?"
)
print(result.data)
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.
Pydantic AI validates every Nhost tool response against typed schemas, catching data inconsistencies at build time. Connect 15 tools through Vinkius and switch between OpenAI, Anthropic, or Gemini without changing your integration code. full type safety, structured output guarantees, and dependency injection for testable agents.
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 Pydantic 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 Pydantic AI
When Pydantic 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 Pydantic AI via MCP
Follow these steps to wire Nhost into Pydantic AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install Pydantic AI
pip install pydantic-aiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.py and run: python agent.pyExplore tools
Why Use Pydantic AI with the Nhost MCP Server
Pydantic AI provides unique advantages when paired with Nhost through the Model Context Protocol.
Full type safety: every MCP tool response is validated against Pydantic models, catching data inconsistencies before they reach your application
Model-agnostic architecture. switch between OpenAI, Anthropic, or Gemini without changing your Nhost integration code
Structured output guarantee: Pydantic AI ensures tool results conform to defined schemas, eliminating runtime type errors
Dependency injection system cleanly separates your Nhost connection logic from agent behavior for testable, maintainable code
Nhost + Pydantic AI Use Cases
Practical scenarios where Pydantic AI combined with the Nhost MCP Server delivers measurable value.
Type-safe data pipelines: query Nhost with guaranteed response schemas, feeding validated data into downstream processing
API orchestration: chain multiple Nhost tool calls with Pydantic validation at each step to ensure data integrity end-to-end
Production monitoring: build validated alert agents that query Nhost and output structured, schema-compliant notifications
Testing and QA: use Pydantic AI's dependency injection to mock Nhost responses and write comprehensive agent tests
Example Prompts for Nhost in Pydantic AI
Ready-to-use prompts you can give your Pydantic 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 Pydantic AI
Common issues when connecting Nhost to Pydantic AI through Vinkius, and how to resolve them.
MCPServerHTTP not found
pip install --upgrade pydantic-aiNhost + Pydantic AI FAQ
Common questions about integrating Nhost MCP Server with Pydantic AI.
How does Pydantic AI discover MCP tools?
MCPServerHTTP instance with the server URL. Pydantic AI connects, discovers all tools, and generates typed Python interfaces automatically.Does Pydantic AI validate MCP tool responses?
Can I switch LLM providers without changing MCP code?
Explore More MCP Servers
View all →
MagicDrip
12 toolsRun LinkedIn outreach campaigns on autopilot with connection requests, follow-ups, and message sequences that feel personal.
Wolfram Alpha
5 toolsSolve math, science, and engineering queries with computational intelligence.
Google Ads
8 toolsEquip your AI agent with direct access to Google Ads — manage search, display, and shopping campaigns, track conversions, and optimize ad spend without opening the Google Ads console.
Onfido
6 toolsAutomate identity verification via Onfido — create applicants, manage workflow runs, and retrieve verification reports directly from any AI agent.