How to Use the Cockpit (Self-hosted Headless CMS API) MCP in Pydantic AI

Q: How do I set up the Cockpit (Self-hosted Headless CMS API) MCP Server with Pydantic AI?

Install using pip install "pydantic-ai-slimmcp". Use the MCPToolset class pointing to your Vinkius HTTP endpoint, then register it in your agent's toolsets argument.

Q: Can I use Pydantic AI to batch update Cockpit (Self-hosted Headless CMS API) collections?

Yes. Your agent invokes batchcontentitems to process multiple records. Every item in the batch is checked against your Pydantic models before being written to your self-hosted database.

Q: How does the agent handle localized content?

It pulls translation data via getlokalizeprojectlocale. Pydantic AI validates that the language keys exist and match your app's locale configuration before applying them to your pages.

Type-safe Cockpit CMS schema validation at runtime with Pydantic AI and MCP.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cockpit (Self-hosted Headless CMS API) MCP to Pydantic AI

Create your Vinkius account to connect Cockpit (Self-hosted Headless CMS API) to Pydantic AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Cockpit (Self-hosted Headless CMS API) with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate Cockpit payloads using Pydantic AI

Stop silent database corruption before it happens. This MCP Server exposes tools like `create_or_update_content_item` which your Pydantic AI agent validates against strict Python models at runtime. If your self-hosted CMS returns an unexpected schema, the agent raises a validation error instantly. This guarantees that your frontend never receives poorly formatted fields or missing image URLs.

Strict route and sitemap verification

Your agent navigates your site structure using `get_page_by_route` and `list_routes`. Pydantic AI parses the raw JSON output into typed objects, ensuring every slug and path matches your application's expected structure. When generating new pages, the agent runs `get_sitemap` to verify that the new route does not collide with existing paths. You get error-free site architecture updates without manual validation scripts.

Type-safe asset and menu management

Manage site layout elements safely using `list_menus` and `get_menu`. Pydantic AI ensures that the returned navigation items match your schema definitions before your agent attempts to modify them. For media, the agent pulls metadata with `get_asset` and generates scaled versions with `get_asset_image`. Your typed models verify that dimensions and aspect ratios are valid integers before sending requests.

Setup guide

Set up Cockpit (Self-hosted Headless CMS API) MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "cockpit-self-hosted-headless-cms-api-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to Cockpit (Self-hosted Headless CMS API) tools.",
)

result = await agent.run("List recent Cockpit (Self-hosted Headless CMS API) transactions")
print(result.output)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Cockpit CMS. 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.

Connect Cockpit (Self-hosted Headless CMS API) now

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 Cockpit (Self-hosted Headless CMS API) MCP in Pydantic AI

Install using `pip install "pydantic-ai-slim[mcp]"`. Use the `MCPToolset` class pointing to your Vinkius HTTP endpoint, then register it in your agent's `toolsets` argument.

The framework raises a validation error immediately rather than letting your agent process corrupt data. This keeps your application state clean and prevents broken content from reaching production.

Yes. Your agent invokes `batch_content_items` to process multiple records. Every item in the batch is checked against your Pydantic models before being written to your self-hosted database.

It pulls translation data via `get_lokalize_project_locale`. Pydantic AI validates that the language keys exist and match your app's locale configuration before applying them to your pages.

We run your connection inside a zero-trust, ephemeral V8 sandbox. Your self-hosted API credentials and localization payloads are never stored, keeping your CMS data isolated and private.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript