# Cockpit MCP for AI Agents AI Agent Connect

> Cockpit (Self-hosted Headless CMS API). It lets you manage your headless content, assets, and menus through any AI agent. Instead of clicking through a dashboard, you can ask your agent to update blog posts, fetch localized strings, or generate image thumbnails. It connects your self-hosted content infrastructure to your favorite AI tools so you can manage your site's data using natural language.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_fNofB8llpPLT1euBpo7Rm0YeaMUb0DsJJHBkdNZ7/ai-agent-connect
- **Tags:** cms, headless, api-first, self-hosted, content-api

## Description

You spend a lot of time jumping between your CMS dashboard and your content editor. It's a tedious loop of copying text, checking status codes, and manually resizing images. This Connector changes that by giving your AI agent a direct line into your Cockpit CMS. You can tell your agent to find specific content items, update prices across a whole collection, or grab the latest translations for a different region without ever opening a browser tab. It handles the heavy lifting of interacting with your content models and assets, making the way you update your site feel like a conversation. You can even pull data from multiple models at once to get a full picture of your content. If you're looking for a way to get your content into your workflow without the friction of a traditional GUI, this is how you do it. You'll find it's much faster to just tell your agent what needs changing and let it handle the API calls. It's part of the Vinkius catalog, making it easy to plug into your existing setup. Instead of dealing with complex headers or auth tokens, you just provide your credentials once and let your agent do the rest. It turns your content infrastructure into a searchable, editable database that your AI can actually interact with in real time.

## Tools

### batch_content_items
Request content from multiple models at once for faster data gathering.

### delete_content_item
Remove a specific content item from your collection using its ID.

### get_asset_image
Generate resized thumbnails or specific image versions on demand.

### get_asset
Retrieve metadata for a specific asset by its unique ID.

### get_content_item
Fetch all the details for a single content item using its ID.

### get_lokalize_project_locale
Get translations for a specific locale within a Lokalize project.

### get_lokalize_project
Pull all translations for an entire Lokalize project.

### get_menu
Retrieve a specific menu by its name from your navigation setup.

### get_page_by_route
Fetch a specific page's information using its unique route.

### get_sitemap
Get the full sitemap of your website's content.

### list_content_items
Fetch a list of items from a collection with filters, sorting, and pagination.

### list_menus
View a list of all menus available in your CMS.

### list_pages
List every page currently defined in your site structure.

### search_detektivo
Search for specific information within a Detektivo index.

### submit_inbox
Send form data directly to an Inbox for processing.

### create_or_update_content_item
Create new content or update existing items if you provide an ID.

### list_routes
Get a lightweight list of all routes and slugs for your site.

## Prompt Examples

**Prompt:** 
```
List the latest 5 blog posts from the 'news' collection.
```

**Response:** 
```
I've pulled the 5 most recent posts from your news collection:

| Date | Title | Author |
| :--- | :--- | :--- |
| Oct 12 | New Feature Launch | Sarah J. |
| Oct 10 | Community Update | Mike R. |
| Oct 08 | Fall Sale News | Sarah J. |
| Oct 05 | Tech Tips | Alex W. |
| Oct 02 | Monthly Recap | Mike R. |

Would you like me to fetch the full body text for any of these?
```

**Prompt:** 
```
Update the price of product ID 99887 to 25.00.
```

**Response:** 
```
I've updated the product (ID: 99887). 

**Changes:**
*   **Price:** $25.00 (Updated from $29.99)
*   **Status:** Success

All other product details remain unchanged. Is there anything else you'd like to modify?
```

**Prompt:** 
```
Get the Spanish translations for the 'homepage' project.
```

**Response:** 
```
I've retrieved the Spanish (es) translations for the 'homepage' project:

*   **Hero Title:** Bienvenido a nuestra tienda
*   **CTA Button:** Comprar ahora
*   **Footer Note:** Envíos gratis en pedidos superiores a 50€

Do you need me to check any other languages?
```

## Capabilities

### Update content items
Change existing content values or create new ones using specific IDs.

### Batch request content
Pull data from multiple content models in one go to save time.

### Generate image thumbnails
Create resized versions of your assets on the fly.

### Manage localized projects
Fetch translations for specific locales from your Lokalize projects.

### Fetch page structures
Retrieve routes and page information from the Pages addon.

## Use Cases

### Bulk updating product prices
A store owner wants to change prices for a sale. They ask the agent to update the price for 10 specific IDs using create_or_update_content_item.

### Site structure auditing
A developer needs to see all current routes to map out a new navigation menu. They use list_routes to see the full list of slugs.

### On-the-fly thumbnail generation
A designer needs a specific thumbnail size for a mobile banner. They ask the agent to generate one using get_asset_image.

### Localized copy verification
A marketing lead wants to see the Spanish version of a landing page. They use get_lokalize_project_locale to pull the correct text.

## Benefits

- Stop manual data entry by using create_or_update_content_item to change prices or descriptions instantly.
- Get a full site overview faster with list_routes and list_pages to see your entire structure.
- Save time on multi-model requests by using batch_content_items to pull several data points at once.
- Handle assets easily with get_asset_image to create thumbnails without needing extra image processing tools.
- Simplify multi-language management by pulling specific translations with get_lokalize_project_locale.

## How It Works

The bottom line is you get a natural language interface for your entire headless content database.

1. Subscribe to the Cockpit MCP on Vinkius.
2. Provide your instance URL and API key in your AI client.
3. Ask your agent to perform tasks like 'Update the price for product ID 123'.

## Frequently Asked Questions

**How can I use Cockpit CMS with my AI agent?**
You can connect your Cockpit CMS instance to your AI agent by subscribing to this Connector. Once connected, you can use natural language to manage your content, assets, and site structure.

**Can the Cockpit CMS MCP update my content automatically?**
Yes, it allows your AI agent to create or update content items directly. You can give it specific instructions to change prices, descriptions, or other fields in your collections.

**Does Cockpit CMS MCP support localized content?**
Yes, it includes tools to fetch translations for specific locales from your projects. This makes it easy to manage and retrieve multi-language content through your AI.

**How do I manage images in Cockpit CMS using an AI?**
The Connector allows your agent to retrieve asset metadata and generate resized thumbnails or specific image versions on demand, saving you from manual editing.

**Can I pull multiple content types at once with Cockpit CMS MCP?**
Yes, you can use the batch request tool to pull data from multiple content models in a single request, which is much faster for large data gathering tasks.

**Is the Cockpit CMS MCP good for managing site routes?**
It is excellent for that. You can use the Connector to list all pages, retrieve specific routes, or get the full sitemap to help your AI understand your site structure.

**Can I filter content items using Mongo-style queries?**
Yes! The `list_content_items` tool supports a `filter` parameter where you can pass a JSON object with Mongo-style query operators to precisely target your data.

**Is it possible to resize images directly through the agent?**
Absolutely. Use the `get_asset_image` tool with parameters like `w` (width), `h` (height), and `m` (mode) to request processed versions of your stored image assets.

**Can I fetch data from multiple collections at once?**
Yes, the `batch_content_items` tool allows you to define multiple models and their respective query parameters in a single JSON object to retrieve all required data in one go.