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.

Umbraco MCP Server for Google ADK 10 tools — connect in under 2 minutes

Name: Umbraco
Availability: InStock
Author: Vinkius

google.github.io/adk-docs/tools/mcp-tools

Built by Vinkius GDPR 10 Tools SDK

Google Agent Development Kit (ADK) is Google's framework for building production AI agents. Add Umbraco as an MCP tool provider through the Vinkius and your ADK agents can call every tool with full schema introspection.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import (
    StreamableHTTPConnectionParams,
)

# Your Vinkius token — get it at cloud.vinkius.com
mcp_tools = McpToolset(
    connection_params=StreamableHTTPConnectionParams(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    )
)

agent = Agent(
    model="gemini-2.5-pro",
    name="umbraco_agent",
    instruction=(
        "You help users interact with Umbraco "
        "using 10 available tools."
    ),
    tools=[mcp_tools],
)

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* 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 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.

Google ADK natively supports Umbraco as an MCP tool provider — declare the Vinkius Edge URL and the framework handles discovery, validation, and execution automatically. Combine 10 tools with Gemini's long-context reasoning for complex multi-tool workflows, with production-ready session management and evaluation built in.

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

The Umbraco MCP Server exposes 10 tools through the Vinkius. Connect it to Google ADK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect Umbraco to Google ADK via MCP

Follow these steps to integrate the Umbraco MCP Server with Google ADK.

Install Google ADK

Run pip install google-adk

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token

Create the agent

Save the code above and integrate into your ADK workflow

Explore tools

The agent will discover 10 tools from Umbraco via MCP

Why Use Google ADK with the Umbraco MCP Server

Google ADK provides unique advantages when paired with Umbraco through the Model Context Protocol.

Google ADK natively supports MCP tool servers — declare a tool provider and the framework handles discovery, validation, and execution

Built on Gemini models, ADK provides long-context reasoning ideal for complex multi-tool workflows with Umbraco

Production-ready features like session management, evaluation, and deployment come built-in — not bolted on

Seamless integration with Google Cloud services means you can combine Umbraco tools with BigQuery, Vertex AI, and Cloud Functions

Umbraco + Google ADK Use Cases

Practical scenarios where Google ADK combined with the Umbraco MCP Server delivers measurable value.

Enterprise data agents: ADK agents query Umbraco and cross-reference results with internal databases for comprehensive analysis

Multi-modal workflows: combine Umbraco tool responses with Gemini's vision and language capabilities in a single agent

Automated compliance checks: schedule ADK agents to query Umbraco regularly and flag policy violations or configuration drift

Internal tool platforms: build self-service agent platforms where teams connect their own MCP servers including Umbraco

Umbraco MCP Tools for Google ADK (10)

These 10 tools become available when you connect Umbraco to Google ADK via MCP:

create_cms_document

Provide the document data as a JSON object adhering to the schema. Creates a new document in the Umbraco CMS

delete_cms_document

This action is irreversible. Permanently deletes a document from the Umbraco CMS

get_delivery_content_by_id

Retrieves a specific content item by its GUID or numeric ID via Delivery API

get_delivery_content_by_path

g., "/home/about"). Retrieves a specific content item by its URL path

get_management_document

Retrieves a specific document via the Umbraco Management API (Drafts/Backoffice)

list_delivery_content

Supports pagination via take and skip. Lists content available via the Umbraco Delivery API

list_document_types

Lists all document types (schemas) defined in Umbraco

list_media_assets

Lists media assets (images, files) from the Umbraco Media library

query_delivery_content

g., "contentType:blogPost"). Filters content items using the Umbraco Delivery API query syntax

update_cms_document

Provide the document ID and JSON updates. Updates fields of an existing document in Umbraco

Example Prompts for Umbraco in Google ADK

Ready-to-use prompts you can give your Google ADK agent to start working with Umbraco immediately.

"Use the delivery API to get the content from '/products/new-feature' and list out its properties."

"Look up our Document Types to see the exact schema required for a 'BlogPost'. Then create one JSON draft placeholder payload based on it."

"Delete the backoffice document holding ID d6ef43..."

Troubleshooting Umbraco MCP Server with Google ADK

Common issues when connecting Umbraco to Google ADK through the Vinkius, and how to resolve them.

McpToolset not found

Update: pip install --upgrade google-adk

Umbraco + Google ADK FAQ

Common questions about integrating Umbraco MCP Server with Google ADK.

How does Google ADK connect to MCP servers?

Import the MCP toolset class and pass the server URL. ADK discovers and registers all tools automatically, making them available to your agent's tool-use loop.

Can ADK agents use multiple MCP servers?

Yes. Declare multiple MCP tool providers in your agent configuration. ADK merges all tool schemas and the agent can call tools from any server in a single turn.

Which Gemini models work best with MCP tools?

Gemini 2.0 Flash and Pro models both support function calling required for MCP tools. Flash is recommended for latency-sensitive use cases, Pro for complex reasoning.