Bring Authentication
to Pydantic AI
Learn how to connect Nhost to Pydantic AI and start using 15 AI agent tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code.
GDPR Free for SubscribersCompatible with every major AI agent and IDE
Gemini
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 Pydantic AI?
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.
- —
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 in Pydantic AI
Nhost and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect Nhost to Pydantic 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 Pydantic 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 Pydantic 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 Pydantic AI
Every tool call from Pydantic 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 Pydantic AI discover MCP tools?
Create an 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?
Yes. When you define result types as Pydantic models, every tool response is validated against the schema. Invalid data raises a clear error instead of silently corrupting your pipeline.
Can I switch LLM providers without changing MCP code?
Absolutely. Pydantic AI abstracts the model layer. your Nhost MCP integration works identically with OpenAI, Anthropic, Google, or any supported provider.
MCPServerHTTP not found
Update: pip install --upgrade pydantic-ai
Explore More MCP Servers
View all →
NASA Exoplanets — Worlds Beyond Our Solar System
4 toolsExplore 5,700+ confirmed exoplanets from NASA's Exoplanet Archive: search by discovery method, find habitable zone candidates, browse transit planets from Kepler and TESS missions, and analyze global discovery statistics spanning three decades of planet hunting.
Jiminny
10 toolsCoach your sales team with conversation intelligence that records calls, identifies winning behaviors, and forecasts deals.
Actionstep
8 toolsRun your law practice smarter with case management, document tracking, and client billing all connected to your AI workflow.
Betterfly
14 toolsAutomate ESG and HR Wellness data via Betterfly — track global corporate steps, extract social donations, and orchestrate health engagement via agents.