Creation Overview

Content creation tools enable AI agents to create, update, and validate content within content type constraints.

Available Tools

create_content

Create new content items

update_content

Update existing content

Validation

All content is validated against the content type’s JSON schema before creation or update. This ensures:

Required fields are present
Field types match the schema
String lengths respect maxLength constraints
Component types match allowed definitions
Asset references point to existing assets

Best Practices

Before Creating Content

Fetch the schema first: Always use get_content_type to understand the structure
Validate asset IDs: Use search_assets to verify assets exist
Check length limits: Review maxLength constraints in the schema
Use correct component types: Match type names exactly as defined

Content Structure

Include all required fields: Check the schema’s required arrays
Follow component patterns: Each component needs a type field
Reference assets by ID: Use { "id": "asset-xxx" } format

Descriptions

Use structured markdown for descriptions:

Brief summary of the content.

**Topics:** Topic1, Topic2, Topic3
**Key points:** Point1, Point2, Point3
**Length:** ~1500 words
**Language:** English

This format helps both humans and AI agents understand the content context.

Common Workflow

// 1. Get the content type schema
const contentType = await mcp.call("get_content_type", {
  contentTypeId: "ct_story_001"
});

// 2. Find assets to use
const assets = await mcp.call("search_assets", {
  query: "hero image",
  type: "image/*"
});

// 3. Create the content
const result = await mcp.call("create_content", {
  typeId: "ct_story_001",
  name: "My New Story",
  content: {
    title: "My New Story",
    asset: { id: assets.items[0].id },
    components: [
      {
        type: "StoryParagraph",
        text: "Opening paragraph..."
      }
    ]
  }
});

// 4. Update if needed
await mcp.call("update_content", {
  contentId: result.id,
  content: {
    // Updated content...
  }
});

Search Assets Create Content

​Available Tools

create_content

update_content

​Validation

​Best Practices

​Before Creating Content

​Content Structure

​Descriptions

​Common Workflow