How to Use the Cosmic MCP in Google ADK
Feed your Cosmic CMS content directly into Gemini's massive context window using the Google ADK to analyze entire media libraries.
Works with every AI agent you already use
…and any MCP-compatible client
Connect Cosmic MCP to Google ADK
Create your Vinkius account to connect Cosmic to Google ADK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.
Multi-gigabyte media audits with Google ADK
Gemini's million-token context window is perfect for analyzing entire media libraries. By connecting the Google ADK to your Cosmic bucket, your agent can run `list_uploaded_media` to pull your entire media index in one go. The agent uses `get_media_asset` to inspect individual image metadata, comparing your Cosmic assets against BigQuery tables to find unused files. If it spots orphans, it can trigger `wipe_media_asset` to clean up your cloud storage via the Google ADK.
Enterprise schema mapping via Google ADK
Large-scale enterprise content models can be incredibly messy. The Google ADK uses `list_schema_types` to map out your entire Cosmic architecture, feeding the structural rules directly into Gemini's reasoning engine. From there, the agent invokes `get_schema_details` to understand exactly which fields are required for your Cosmic database. This lets you cross-reference your CMS structure with Vertex AI datasets to ensure your content fields match your machine learning models.
Bulk draft writing using this Cosmic MCP Server
Instead of copying text manually, let your Google ADK agent write directly to your Cosmic bucket. The agent can fetch existing entries with `get_single_object` and then use `patch_cms_object` to update localized copy in bulk. When generating fresh content from your Google Cloud pipelines, this Cosmic MCP Server lets the agent invoke `create_cms_object` to push structured JSON drafts instantly. It eliminates the manual copy-paste loop entirely between Gemini and Cosmic.
Set up Cosmic MCP in Google ADK
Prerequisites
- Python 3.10+ installed
-
google-adkpackage (pip install google-adk) - Active Vinkius subscription with a valid endpoint token
- 1
Install Google ADK
Run
pip install google-adkto install the Agent Development Kit. MCP support is included via theMcpToolsetclass. - 2
Connect via SSE transport
Use
McpToolset.from_server()withSseServerParamspointing to your Vinkius endpoint. Replace[YOUR_TOKEN_HERE]with your token from cloud.vinkius.com. - 3
Create an LlmAgent
Pass the returned
mcp_toolslist directly toLlmAgent(tools=mcp_tools). The ADK maps each MCP tool to a native Gemini function call — no manual schema definitions required. - 4
Run with any Gemini model
The agent works with any Gemini model (
gemini-2.0-flash,gemini-2.5-pro, etc.). Copy the full example on the right to get started with Cosmic tools in your ADK agent.
from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import SseServerParams
# Connect to the MCP via SSE
mcp_tools, exit_stack = await McpToolset.from_server(
connection_params=SseServerParams(
url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)
)
# Create your agent with auto-discovered tools
agent = LlmAgent(
name="Cosmic_agent",
model="gemini-2.0-flash",
instruction="You have access to Cosmic tools via MCP.",
tools=mcp_tools,
) Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Cosmic. 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.
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 Cosmic MCP in Google ADK
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the Cosmic MCP today
We host it, we monitor it, we maintain it. You just paste one token.