Bring Cms
to Pydantic AI
Create your Vinkius account to connect Umbraco to Pydantic AI and start using all 10 AI tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code. No hosting, no server setup — just connect and start using.
GDPR Free for SubscribersCompatible with every major AI agent and IDE
Gemini
What is the Umbraco MCP Server?
Connect your Umbraco CMS backend to any AI agent and take full autonomous control bridging the powerful Delivery and Management APIs purely through natural conversation.
What you can do
- Delivery API Traversing — Instantly list public pages, query by content type, or securely fetch structured fields by their exact domain paths organically
- Backoffice Document Control — Push new document permutations natively adhering to your configured schemas without opening a single GUI panel
- Site Mutations — Command the targeted removal of any outdated published nodes or force updates to internal fields seamlessly via
update_cms_document - Schema & Media Insight — Grab absolute lists tracking your stored binary media files alongside the global Document Types blueprints mapped out natively
How it works
- Subscribe manually to this connected MCP server
- Inject your active Umbraco Base URL mapping and your Management/Delivery Bearer Auth Token
- Engage directly your preferred AI model (Claude or Cursor) asking it to index pages natively
Eliminate messy IDE switching while structuring robust Headless projects. Let the AI prototype content inside Umbraco dynamically utilizing REST interfaces.
Who is this for?
- CMS Platform Engineers — automate routine headless content extractions requesting schema structures from the LLM avoiding UI switch delays
- Digital Editors — prompt the agent to bulk-view lists of raw content items skipping complicated table drill-downs natively
- Frontend Architects — rapidly confirm internal content API stability extracting pure JSON payloads mapping to visual interfaces directly
Built-in capabilities (10)
Provide the document data as a JSON object adhering to the schema. Creates a new document in the Umbraco CMS
This action is irreversible. Permanently deletes a document from the Umbraco CMS
Retrieves a specific content item by its GUID or numeric ID via Delivery API
g., "/home/about"). Retrieves a specific content item by its URL path
Retrieves a specific document via the Umbraco Management API (Drafts/Backoffice)
Supports pagination via take and skip. Lists content available via the Umbraco Delivery API
Lists all document types (schemas) defined in Umbraco
Lists media assets (images, files) from the Umbraco Media library
g., "contentType:blogPost"). Filters content items using the Umbraco Delivery API query syntax
Provide the document ID and JSON updates. Updates fields of an existing document in Umbraco
Why Pydantic AI?
Pydantic AI validates every Umbraco tool response against typed schemas, catching data inconsistencies at build time. Connect 10 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 Umbraco integration code
- —
Structured output guarantee: Pydantic AI ensures tool results conform to defined schemas, eliminating runtime type errors
- —
Dependency injection system cleanly separates your Umbraco connection logic from agent behavior for testable, maintainable code
Umbraco in Pydantic AI
Why run Umbraco with Vinkius?
The Umbraco connection runs on our fully managed, secure cloud infrastructure. We handle the hosting, maintenance, and security so you don't have to deal with servers or code. All 10 tools are ready to work instantly without any complex setup.
You stay in complete control of your data. Your AI only accesses the information you approve, keeping your sensitive passwords and private details completely safe. Plus, with automatic optimizations, your AI works faster and more efficiently.
* Every connection is hosted and maintained by Vinkius. We handle the security, updates, and infrastructure so you don't have to write code or manage servers. See our infrastructure
Over 4,000 integrations ready for AI agents
Explore a vast library of pre-built integrations, optimized and ready to deploy.
Connect securely in under 30 seconds
Generate tokens to authenticate and link external services in a single step.
Complete visibility into every agent action
Audit live requests, latency, success rates, and active security compliance policies.
Optimize spending and track token ROI
Analyze real-time token consumption and cost metrics detailed by connection.
Explore our live AI Agents Analytics dashboard to see it all working
This dashboard is included when you connect Umbraco using Vinkius. You will never be left in the dark about what your AI agents are doing with your tools.
Umbraco and 4,000+ other AI tools. No hosting, no code, ready to use.
Professionals who connect Umbraco to Pydantic AI through Vinkius don't need to write code, manage servers, or worry about security. Everything is pre-configured, secure, and runs automatically in the background.
Raw MCP | Vinkius | |
|---|---|---|
| Ready-to-use MCPs | Find and configure each manually | 4,000+ MCPs ready to use |
| Connection Setup | Manual coding & server setup | 1-click instant connection |
| Server Hosting | You host it yourself (needs 24/7 uptime) | 100% hosted & managed by Vinkius |
| Security & Privacy | Stored in plaintext config files | Bank-grade encrypted vault |
| Activity Visibility | Blind execution (no logs or tracking) | Live dashboard with real-time logs |
| Cost Control | Runaway AI token spend risk | Automatic budget limits |
| Revoking Access | Must delete files or code to stop | 1-click disconnect button |
How Vinkius secures
Umbraco for Pydantic AI
Every request between Pydantic AI and Umbraco is protected by our secure gateway. We automatically keep your sensitive data private, prevent unauthorized access, and let you disconnect instantly at any time.
Frequently asked questions
Can it easily retrieve the content of a page assuming I only know its URL path?
Absolutely. Instruct the agent to 'get_delivery_content_by_path' and supply something like '/home/about'. It traverses the Delivery API native routing map and returns perfectly all inner block grids and content variables attached.
How do I ensure the JSON payloads for `create_cms_document` are exactly what Umbraco expects?
Use the agent to first run 'list_document_types'. It pulls down the global schema blueprints. The LLM can explicitly read the allowed field types (like rich text or media pickers) and logically construct the insertion matching it exactly.
Does it pull media details dynamically?
Yes. Pinging 'list_media_assets' grants full insight over all stored visuals inside your Umbraco media containers, returning URL addresses alongside fundamental dimension formats so the agent can reference them anywhere.
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 Umbraco 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 →
Cohere
6 toolsAccess Cohere AI models via API — chat with Command models, generate embeddings, rerank documents and tokenize text from any AI agent.
GatherUp
12 toolsManage customer reviews, track feedback, and automate review requests via AI agents with GatherUp.
FDA (openFDA)
12 toolsAccess public health data via openFDA — search drug labeling, monitor adverse events, and track food recalls directly through your AI agent.
Google Forms
2 toolsAnalyze datasets actively — list active Google Forms, query exact responses, and fetch metadata programmatically.