# Cosmic MCP for AI Agents AI Agent Connect > Cosmic (Headless CMS & Content API) lets you manage your content, media, and object types directly through your AI agent. You can create new objects, upload files, and update schemas using natural language instead of navigating a complex dashboard. It brings your headless CMS infrastructure into your existing AI workflows. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_y2ynjJhQkEayFecto8VFFnli76mgjWmwXZolbG6r/ai-agent-connect - **Tags:** cms-api, content-infrastructure, media-management, api-first, json-api ## Description Instead of switching tabs between your content management system and your content production tools, this Connector lets you handle your entire content lifecycle where you already work. You can tell your agent to draft a new blog post, upload a set of hero images, or check the status of a specific content entry. It connects your Cosmic bucket to your AI client, making it possible to update metadata or organize media assets on the fly. If you're tired of the friction of manual data entry, this is the shortcut. By using the Vinkius catalog to connect this Connector, you get a direct line to your content infrastructure. You can audit existing entries, create new object types to expand your content model, and manage revisions without ever touching a browser tab. It turns your AI into a content operations specialist who understands your specific bucket structure and content rules. You no longer have to worry about the tedious steps of navigating nested menus or manually typing in fields for every single entry. Whether you are updating a product description, changing an image tag, or auditing your entire media library for consistency, your agent does the heavy lifting. This means you can spend more time on the creative side of your work while the technical management of your content stays organized and up to date automatically. ## Tools ### create_media Upload new images or videos to your Cosmic bucket. This helps you populate your media library quickly. ### create_object Create a new content object in your bucket. Use this to start a new blog post or product entry. ### create_object_type Define a new object type for your content. This allows you to expand your content model programmatically. ### create_revision Create a new revision for a specific object. This is useful for saving a snapshot before making major changes. ### delete_media Remove images or videos from your bucket. Use this to clean up old or unused assets. ### delete_object_type Remove an entire object type from your bucket. Use this when you no longer need a specific content structure. ### get_agent_conversation_history Retrieve past messages from a specific agent conversation. This helps you see what your agent has done previously. ### get_object Fetch a single object by its unique ID. Use this to pull specific data for a content entry. ### get_object_type Retrieve the details of an object type using its slug. This is great for checking your current schema. ### get_revision Pull a specific version of an object. Use this to see what an entry looked like in the past. ### list_agent_conversations See a list of all conversations with your AI agent. This provides a history of your interactions. ### list_media Show all media files currently in your bucket. Use this to audit your existing image and video assets. ### list_object_types List all the different object types available in your bucket. This helps you see your full content model. ### list_objects Query and list objects in your bucket using filters. Use this to find specific content entries quickly. ### list_revisions Get all previous versions for a specific object. This lets you track the history of a content entry. ### send_agent_message Send a new message to your AI agent. Use this to trigger new actions or queries. ### update_media Update the metadata for existing media files. This is useful for changing descriptions or tags on images. ### delete_object Delete a specific content object. This helps you remove outdated entries from your CMS. ### update_object Modify an existing content object. Use this to edit blog posts, products, or other entries. ### update_object_type Edit the structure of an existing object type. Use this to change fields or requirements in your CMS. ### batch_objects Run up to 25 operations on multiple objects at once. This is the fastest way to perform bulk updates. ## Prompt Examples **Prompt:** ``` List the last 5 objects of type 'news' in my bucket. ``` **Response:** ``` I've retrieved the latest 'news' objects. Here are the most recent entries: | Entry Title | ID | | :--- | :--- | | **Product Launch** | abc1 | | **New Partnership** | abc2 | | *3 others* Would you like to see the full content of any of these? ``` **Prompt:** ``` Create a new draft post titled 'AI and CMS' with the type 'blog-posts'. ``` **Response:** ``` Successfully created the draft object **'AI and CMS'** (ID: xyz789) in the 'blog-posts' category. You can now add metadata or publish it when ready. ``` **Prompt:** ``` Show me all media files currently in the bucket. ``` **Response:** ``` I found 12 media assets in your bucket. Recent uploads include: * hero-banner.jpg * logo-white.png * intro-video.mp4 Do you need the URL for any specific file? ``` ## Capabilities ### Create content entries Generate new objects in your buckets with specific metadata. ### Upload media assets Add images, videos, and documents to your media library. ### Modify object schemas Create or update object types to change your content structure. ### Manage content revisions Track changes and restore previous versions of your content. ### Perform batch updates Run multiple operations on objects at once for faster updates. ## Use Cases ### Drafting a new blog post A content manager asks the agent to create a draft for 'AI in CMS' using `create_object` and then asks to upload a hero image with `create_media`. ### Content Auditing A developer wants to see all media files in a bucket. They use `list_media` to find old assets and `delete_media` to remove the ones they don't need. ### Schema Updates A product manager needs to add a new field to all product types. They use `update_object_type` to modify the structure without touching the CMS dashboard. ### Bulk Metadata Correction A team needs to update the category for 20 different objects. They use `batch_objects` to perform the update in one single request. ## Benefits - Eliminate manual dashboard navigation by using `list_objects` and `get_object` to find content directly in your chat. - Speed up content creation by using `create_object` to draft entries using natural language instead of manual forms. - Simplify media management with `list_media` and `create_media`, letting you organize your library without extra tabs. - Maintain content integrity by using `create_revision` and `list_revisions` to track and roll back changes. - Update your entire content model quickly with `update_object_type` and `create_object_type` to reflect new requirements. - Execute large-scale updates in seconds using `batch_objects` to modify multiple content entries at once. ## How It Works The bottom line is you get a natural language interface for your entire Cosmic content infrastructure. 1. Subscribe to the Cosmic MCP on the Vinkius marketplace. 2. Enter your Cosmic Bucket Slug, Read Key, and Write Key in your client settings. 3. Ask your agent to perform tasks like listing objects or uploading media. ## Frequently Asked Questions **Can the Cosmic MCP help me manage my content without opening the CMS dashboard?** Yes, it lets you perform almost every content management task through your AI client. You can create, read, update, and delete objects using natural language instead of clicking through menus. **How does the Cosmic MCP handle media like images and videos?** It provides direct access to your media library. You can upload new files, list all existing assets, and update their metadata directly through your agent. **Can I use the Cosmic MCP to change my content structure?** Yes, it allows you to manage object types. You can create or update the schemas for your content, making it easy to modify how your data is structured. **Is it possible to undo changes made to my content using the Cosmic MCP?** You can manage revisions for your objects. The Connector lets you see previous versions and restore them, providing a safety net for your content updates. **Can I perform bulk updates on my content with the Cosmic MCP?** Yes, the Connector includes a tool for batch operations. You can update up to 25 objects in a single request, which is much faster than doing them individually. **What keys do I need to connect the Cosmic MCP?** You will need your Cosmic Bucket Slug, a Read Key, and a Write Key. These are provided in your Cosmic dashboard and allow the Connector to securely interact with your data. **Can I filter objects by a specific type like 'blog-posts'?** Yes! Use the `list_objects` tool and provide a JSON query string like `{"type":"blog-posts"}` in the query parameter to filter your results. **How do I update the content of an existing object?** You can use the `update_object` tool. Provide the Object ID and the new values for `title`, `metadata`, or `status` to modify the entry. **Is it possible to see who made changes to an object?** Yes, you can use the `list_revisions` tool for a specific object to see its history, and `get_revision` to inspect the details of a specific version.