# CoreMedia Content Cloud MCP for AI Agents MCP

> CoreMedia Content Cloud gives your AI agent direct access to a headless digital experience platform. It lets you query all site data—from articles and navigation menus to global images and brand configurations—using structured GraphQL requests. You can search across the entire content catalog or fetch specific assets by path, making it ideal for developers needing programmatic control over CMS architecture.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** graphql, digital-experience, composable-dxp, content-delivery, enterprise-cms, api-first

## Description

This MCP connects your AI agent directly to CoreMedia's full content cloud. Instead of jumping through a web UI and copying data piece by piece, your agent talks straight to the source. You can ask it things like, 'Give me all articles related to sustainability' or 'What are the navigation links for our European site?' It executes complex GraphQL queries under the hood, handling everything from nested menus to global asset URIs. When you connect this through Vinkius, your agent gains total control over your digital experience platform, letting you manage content and audit schemas right inside your chat window or IDE. You'll get reliable data instantly, whether you need article bodies, site context, or brand hierarchy details.

## Tools

### execute_graphql_payload
Runs custom GraphQL queries to map out specific data routing spaces within the CMS schema.

### get_cmarticle_path
Extracts structured properties and full details for an active article node using its path.

### get_cmpicture_asset
Retrieves specific asset information, tracing detailed logs for image assets.

### get_navigation_tree
Identifies the exact array structure of native navigation menus across the site.

### get_cmchannel_page
Lists structured rules and layouts for an entire content channel or section page.

### get_site_context
Retrieves structural details confirming multi-brand site environment variations.

### get_cmviewtypes
Determines available application nodes and the underlying database structure for content views.

### get_introspection_query
Checks the system schema automatically to validate active model extensions and data types.

### execute_persisted_query
Runs pre-compiled, optimized queries against global content boundaries for high performance.

### search_global_content
Performs deep full-text searches across all available nodes to pinpoint specific content records.

## Prompt Examples

**Prompt:** 
```
What are all my current navigation options for a new product line?
```

**Response:** 
```
**Navigation Hierarchy Audit**

*   **Root:** Products
    *   Product A: (Path: /products/a) - Active
    *   Product B: (Path: /products/b) - Needs Review
    *   Service Line X: (Path: /services/x) - Active
*   **Site Context:** This structure applies to the 'English-US' locale and is confirmed against the primary brand configuration. You can also check sub-channels for specific regional requirements.
```

**Prompt:** 
```
I need a full report on all articles mentioning 'sustainability' last year.
```

**Response:** 
```
**Global Content Search Results**

Found 4 matching articles:

1.  `/global/csr/2023-report`: Full article content retrieved (HTML body available).
2.  `/news/eco-initiatives`: Title: Eco-Friendly Practices. Last updated: 2023-11-01.
3.  `/products/solar-panel`: Section details show sustainability features section is active.
4.  `/corporate/investor-relations`: Mentions ESG goals in the metadata.
```

**Prompt:** 
```
What's the structure of our main 'About Us' page?
```

**Response:** 
```
**CMChannel Layout Details**

The 'About Us' channel is composed of three primary sections:

*   **Section 1: Our Mission:** Uses a rich text grid (Metadata Type: `TextBlock`).
*   **Section 2: Leadership Team:** Requires an image asset and name metadata. Asset ID required.
*   **Section 3: History Timeline:** Structured using timeline components. 

*Need me to find the best image asset for the leadership team section?*
```

## Capabilities

### Execute complex GraphQL queries
Send arbitrary payloads to define precise content structures within the CoreMedia Delivery Schema.

### Retrieve full articles and channels by path
Fetch complete HTML grids, metadata, and structural details for specific content nodes like articles or entire site channels.

### Search all global assets
Run deep, full-text searches across every piece of content in the system to find matching records instantly.

### Map navigation and site context
Determine the exact structure of your website's menus, hierarchies, and brand settings for any given locale.

## Use Cases

### Finding all legal disclaimers for the EU site
A marketer needs to verify if a new product page has the required GDPR disclaimers. Instead of manually checking 10 different pages, they prompt their agent: 'Show me the navigation tree and associated content context for European locales.' The MCP uses `get_navigation_tree` and `get_site_context` to return all relevant paths instantly.

### Building a data validation endpoint
A front-end developer needs to ensure their CMS connection handles future content types. They ask the agent to validate the schema using `get_introspection_query`. The MCP returns the full list of dynamic headless types, allowing the dev to code against the correct structure before testing.

### Global content audit for a new campaign
A product team needs to find every mention of 'AI Ethics' across all global articles and channels. They prompt the agent with: 'Search globally for anything about AI ethics.' The MCP uses `search_global_content` to return every matching article path, saving hours of manual auditing.

### Checking an old page's content structure
An architect is reviewing a legacy site section and needs to know its exact layout components. They ask the agent for the channel details for the specific URL. The MCP executes `get_cmchannel_page`, returning the full structured ruleset so the architect can report on the component breakdown.

## Benefits

- Instantly audit content structure and asset locations. Instead of navigating the CoreMedia Studio UI, your agent finds article details or navigation paths directly via `get_cmarticle_path`.
- Reduce development time by accessing complex schema information. Use `get_introspection_query` to validate active model extensions and verify data types without manual setup.
- Improve content governance by visualizing site context. The `get_site_context` tool confirms brand variations and multi-brand environment rules in a single query.
- Accelerate debugging with asset details. Use `get_cmpicture_asset` to pull explicit image metadata, solving placement issues without checking file systems.
- Boost search capability across the entire site. The `search_global_content` function lets you find content matching keywords anywhere in the global catalog.
- Optimize performance by using compiled queries. Running a `execute_persisted_query` ensures your front-end always loads optimized data, skipping unnecessary steps.

## How It Works

The bottom line is you get programmatic access to deep CMS data without writing boilerplate GraphQL queries yourself.

1. Subscribe to this MCP on Vinkius and supply your CoreMedia GraphQL Host URL along with an Access Token.
2. Your AI client uses the credentials to establish a secure connection, allowing it to read the entire content schema.
3. You prompt your agent naturally (e.g., 'What are our product categories?') and the MCP executes the necessary structured query to return precise data.

## Frequently Asked Questions

**How can CoreMedia Content Cloud help me audit my site's content structure?**
This MCP allows your AI agent to programmatically map out every menu, hierarchy level, and section component of your digital experience. You don't have to click around; you simply ask the system to verify the full navigation tree or brand context for any given page.

**Can I use CoreMedia Content Cloud MCP to find all articles about a specific topic?**
Yes. The agent uses global search capabilities across all content nodes, finding every article and channel that matches your keywords. It returns the full path and summary for quick auditing.

**Is CoreMedia Content Cloud MCP good for front-end developers?**
Absolutely. Developers can use this MCP to test complex GraphQL queries, retrieve asset metadata (like image details), and validate schemas directly from their chat or IDE. It's perfect for pre-build testing.

**Does CoreMedia Content Cloud help with multi-brand sites?**
Yes. You can use the MCP to retrieve site context, verifying which brand configurations and locale metadata apply to a given content piece. It ensures your code respects all global environment rules.

**What if I need to know what types of assets are available?**
The agent can perform schema introspection queries to show you every active model extension and data type the CMS supports, giving you a complete map of your content capabilities.