# Elemeno MCP MCP

> Elemeno lets your AI agent talk directly to a headless CMS. You can check publishing statuses, list all content collections, pull global page data, and audit your entire site's content structure right from chat.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** api-first, content-modeling, schema-management, data-collections, web-development, json-api

## Description

Need to know what’s published and what needs fixing across your whole website? This MCP connects you to Elemeno, which handles the backend for many modern sites. Think of it as giving your AI agent direct access to the CMS database without needing a developer to write a single query. You can ask simple questions—like 'How many products are currently drafted?' or 'What fields does the blog collection use?'—and get instant answers. It’s perfect for content teams and developers who need visibility into complex digital assets fast. When you connect this MCP via Vinkius, your agent acts as a single pane of glass over all your content collections and singleton global pages. You manage everything through conversation, tracking items, checking publishing statuses, and even getting high-level summaries of how healthy the entire CMS is.

## Tools

### get_elemeno_account_metadata
Pulls account limits and overall usage statistics for your Elemeno project.

### get_collection_details
Fetches detailed settings and field schemas for any specific content collection.

### get_collection_item_details
Retrieves the full content data and metadata for a single item inside a collection.

### quick_content_volume_audit
Provides an immediate, high-level summary of activity across collections and singletons.

### get_singleton_content
Gets the full content data for a unique global page or site setting.

### list_content_collections
Retrieves a list of all unique content collections defined in your account.

### list_collection_items
Lists every available piece of content within a chosen collection.

### list_published_content
Identifies and lists only those items that are currently marked with a 'Published' status.

### list_content_singletons
Lists all global singleton blocks, like contact pages or site settings.

### search_collection_content
Finds specific items within a collection using keywords in the title or slug.

## Prompt Examples

**Prompt:** 
```
List all content collections in my project.
```

**Response:** 
```
I've found 4 collections, including 'Blog Posts', 'Team Members', and 'Products'. Would you like to see the items within the Blog Posts collection?
```

**Prompt:** 
```
Show me the items in the 'Services' collection.
```

**Response:** 
```
The Services collection has 5 items, including 'Web Design' (published), 'SEO Optimization' (published), and 'Mobile App Dev' (draft). Should I pull the full content for Web Design?
```

**Prompt:** 
```
What is the content of the 'Contact Page' singleton?
```

**Response:** 
```
The 'Contact Page' singleton contains fields for 'Hero Title', 'Office Address', and 'Support Email'. The published title is 'Get in Touch with Us'. Would you like the full JSON data for this page?
```

## Capabilities

### List available content types
Retrieve a full list of all content collections configured in your account.

### View collection structure and fields
Get detailed metadata, including the exact field schemas, for any specific content collection.

### Find and retrieve individual items
Pull the full text and data for a single piece of content within a collection.

### Search published assets by keyword
Search across all collections using keywords in titles or slugs to find relevant content.

## Use Cases

### Preparing for a launch
The Content Manager knows 15 blog posts are ready but needs confirmation. They ask the agent to run `list_published_content` on the 'Blog Posts' collection. The agent confirms that all 15 items have a 'Published' status, allowing the team to schedule the launch with confidence.

### Debugging missing fields
The Web Developer sees an error because the product page is missing a required field. They use `get_collection_details` on the 'Product' collection and immediately see that the 'Material Spec' field schema was never added, fixing the bug instantly.

### Finding outdated global settings
The Operations Team is updating site branding. They ask the agent to check all singletons using `list_content_singletons`. The agent flags a singleton named 'Contact Page' that hasn't been updated in six months, pointing the team toward stale data.

### Reviewing project scope
The Product Owner wants to know how many content types exist. They ask the agent to run `list_content_collections`. The agent returns a list of all 8 collections, confirming that the new 'Partners' collection was successfully added.

## Benefits

- Instantly check publishing statuses. Need to know if an item is 'draft' or 'published'? Use `list_published_content` to filter content and confirm readiness without clicking into the admin panel.
- Audit your entire site structure. Instead of guessing what data fields exist, run a quick audit using `quick_content_volume_audit` to get immediate metadata on activity levels across all collections.
- Deep dive into specific assets. If you need the full text and settings for one item, calling `get_collection_item_details` pulls everything in one go, bypassing multiple page loads.
- Understand global data points. Want to know what's in your 'About Us' page? Use `list_content_singletons` first, then call `get_singleton_content` for the full JSON payload.
- Find content fast. Don't scroll through hundreds of items. Use `search_collection_content` and provide a keyword to pull up exactly what you need by title or slug.
- View the big picture. Start by calling `list_content_collections` to see every piece of structured data your site uses, giving you an overview before diving into specifics.

## How It Works

The bottom line is that it turns complex CMS backend queries into simple conversations with your agent.

1. Connect your AI agent to the Elemeno MCP and authorize it using your project's API key.
2. Tell your agent what you need—for example, 'Show me all published items in the Services collection.'
3. The MCP executes the necessary calls and returns clean data detailing item counts, schemas, or full content bodies.

## Frequently Asked Questions

**How do I check if a singleton page exists using `list_content_singletons`?**
Simply ask the agent to run `list_content_singletons`. This command returns every unique global content block your site uses, like 'Contact Page' or 'Global Footer Settings', giving you an immediate inventory.

**What is the difference between `list_collection_items` and `search_collection_content`?**
Listing items (`list_collection_items`) gives you a count and names of everything in a collection. Searching allows you to narrow that down by title or slug keyword, giving you precise results.

**Can I check my account limits with `get_elemeno_account_metadata`?**
Yes. Running `get_elemeno_account_metadata` retrieves your current usage statistics and any defined content limits, so you always know where you stand.

**How do I find the full data for a single product page using `get_collection_item_details`?**
Specify the collection and the item's unique identifier. The agent executes `get_collection_item_details`, returning all metadata, rich text, and structured fields in one payload.

**How can I check the field schemas for all my content collections using `get_collection_details`?**
It retrieves detailed settings and schema information for a specified collection. This is crucial because it shows you exactly what data points are available before you write any code or run complex queries against that content.

**What is the best way to identify only published content using `list_published_content`?**
This tool filters and returns a list of items currently marked as 'Published.' It’s ideal for building workflows or generating reports where you need to guarantee that all retrieved data is live on your production site.

**Can I run an overall content health check using `quick_content_volume_audit`?**
Yes, it provides a quick, high-level summary of activity across both collections and singletons. You get key metrics like total item counts instantly without having to pull massive amounts of raw data first.

**If I know the slug, how do I retrieve all fields using `get_singleton_content`?**
You supply the unique identifier or slug to pull the complete content payload for that specific singleton block. This gives you all the structured data in one go, ready for use in your application logic.

**How do I get an Elemeno API Key?**
Log in to your Elemeno dashboard, select your project, navigate to **Settings > API**, and you can retrieve your unique API Key from there.

**Does the integration support draft content?**
Yes, you can use the list_collection_items tool to see all items, including their status (e.g., draft or published). Specific content retrieval depends on your API key permissions.

**Can the agent update content via the API?**
This integration currently focuses on listing and auditing content. Creating or updating items and singletons should be managed via the Elemeno dashboard or specific management API endpoints.