Organization Tools

8 MCP tools for organizing content into projects, groups, and folders. Create hierarchical structures and move articles between folders.

Content is organized in a four-level hierarchy: Project > Group > Folder > Articles. A project is the top-level container (e.g., a content cluster or campaign). Groups subdivide projects into logical sections. Folders hold individual articles and can be moved between groups.

aeo_list_projects

List all projects for a domain with their nested groups, folders, and article counts. Returns the full organizational tree in a single call.

Parameters

Name	Type	Required	Description
`domain`	string	Required	Client domain (e.g., "understoodcare.com")

Example

json

aeo_list_projects({ domain: class="code-string">"understoodcare.com" })

Example Response

response

{
  class="code-string">"domain": class="code-string">"understoodcare.com",
  class="code-string">"projects": [
    {
      class="code-string">"project_id": class="code-string">"proj-abc-123",
      class="code-string">"name": class="code-string">"CDPAP Content Cluster",
      class="code-string">"description": class="code-string">"Hub + supporting articles for CDPAP topic",
      class="code-string">"icon": class="code-string">"📋",
      class="code-string">"color": class="code-string">"class="code-commentclass="code-string">">#4A90D9",
      class="code-string">"status": class="code-string">"active",
      class="code-string">"groups": [
        {
          class="code-string">"group_id": class="code-string">"grp-def-456",
          class="code-string">"name": class="code-string">"Eligibility Guides",
          class="code-string">"folders": [
            {
              class="code-string">"folder_id": class="code-string">"fld-ghi-789",
              class="code-string">"name": class="code-string">"New York CDPAP",
              class="code-string">"article_count": 3
            }
          ]
        }
      ]
    }
  ]
}

aeo_create_project

Create a new top-level content project for a domain. Projects are the highest level of organization - use them for content clusters, campaigns, or major topic areas.

Parameters

Name	Type	Required	Description
`domain`	string	Required	Client domain
`name`	string	Required	Project name
`description`	string	Optional	Project description or goals
`icon`	string	Optional	Emoji icon for the project
`color`	string	Optional	Hex color code (e.g., "#4A90D9")

Example

json

aeo_create_project({
  domain: class="code-string">"understoodcare.com",
  name: class="code-string">"CDPAP Content Cluster",
  description: class="code-string">"Hub + supporting articles for CDPAP topic",
  icon: class="code-string">"📋",
  color: class="code-string">"class="code-commentclass="code-string">">#4A90D9"
})

Example Response

response

{
  class="code-string">"project_id": class="code-string">"proj-abc-123",
  class="code-string">"domain": class="code-string">"understoodcare.com",
  class="code-string">"name": class="code-string">"CDPAP Content Cluster",
  class="code-string">"status": class="code-string">"active"
}

aeo_create_group

Create a group within an existing project. Groups subdivide projects into logical sections - for example, a content cluster project might have groups for "Eligibility Guides", "How-To Articles", and "FAQ Pages".

Parameters

Name	Type	Required	Description
`project_id`	string	Required	Parent project UUID
`name`	string	Required	Group name
`description`	string	Optional	Group description
`icon`	string	Optional	Emoji icon for the group
`color`	string	Optional	Hex color code

Example

json

aeo_create_group({
  project_id: class="code-string">"proj-abc-123",
  name: class="code-string">"Eligibility Guides",
  description: class="code-string">"State-by-state CDPAP eligibility requirements",
  icon: class="code-string">"📑"
})

Example Response

response

{
  class="code-string">"group_id": class="code-string">"grp-def-456",
  class="code-string">"project_id": class="code-string">"proj-abc-123",
  class="code-string">"name": class="code-string">"Eligibility Guides"
}

aeo_create_folder

Create a folder within a group. Folders are the lowest organizational level and directly contain articles. Each folder typically holds one article and its related assets.

Parameters

Name	Type	Required	Description
`group_id`	string	Required	Parent group UUID
`name`	string	Required	Folder name
`description`	string	Optional	Folder description
`icon`	string	Optional	Emoji icon for the folder
`color`	string	Optional	Hex color code

Example

json

aeo_create_folder({
  group_id: class="code-string">"grp-def-456",
  name: class="code-string">"New York CDPAP",
  description: class="code-string">"NY-specific CDPAP eligibility and enrollment",
  icon: class="code-string">"📄"
})

Example Response

response

{
  class="code-string">"folder_id": class="code-string">"fld-ghi-789",
  class="code-string">"group_id": class="code-string">"grp-def-456",
  class="code-string">"name": class="code-string">"New York CDPAP"
}

aeo_update_project

Update project metadata. Only provided fields are changed - omitted fields remain unchanged. Set status to archived to hide a completed project from active views.

Parameters

Name	Type	Required	Description
`project_id`	string	Required	Project UUID to update
`name`	string	Optional	New project name
`description`	string	Optional	New description
`icon`	string	Optional	New emoji icon
`color`	string	Optional	New hex color code
`status`	string	Optional	"active" or "archived"

Example

json

aeo_update_project({
  project_id: class="code-string">"proj-abc-123",
  name: class="code-string">"CDPAP Content Cluster (Complete)",
  status: class="code-string">"archived"
})

Example Response

response

{
  class="code-string">"project_id": class="code-string">"proj-abc-123",
  class="code-string">"updated_fields": {
    class="code-string">"name": class="code-string">"CDPAP Content Cluster (Complete)",
    class="code-string">"status": class="code-string">"archived"
  }
}

aeo_update_group

Update group metadata. Only provided fields are changed. Use this to rename, recolor, or archive a group within a project.

Parameters

Name	Type	Required	Description
`group_id`	string	Required	Group UUID to update
`name`	string	Optional	New group name
`description`	string	Optional	New description
`icon`	string	Optional	New emoji icon
`color`	string	Optional	New hex color code
`status`	string	Optional	"active" or "archived"

Example

json

aeo_update_group({
  group_id: class="code-string">"grp-def-456",
  name: class="code-string">"State Eligibility Guides",
  icon: class="code-string">"🗺️"
})

Example Response

response

{
  class="code-string">"group_id": class="code-string">"grp-def-456",
  class="code-string">"updated_fields": {
    class="code-string">"name": class="code-string">"State Eligibility Guides",
    class="code-string">"icon": class="code-string">"🗺️"
  }
}

aeo_update_folder

Update folder metadata. Only provided fields are changed. Use this to rename, recolor, or archive a folder within a group.

Parameters

Name	Type	Required	Description
`folder_id`	string	Required	Folder UUID to update
`name`	string	Optional	New folder name
`description`	string	Optional	New description
`icon`	string	Optional	New emoji icon
`color`	string	Optional	New hex color code
`status`	string	Optional	"active" or "archived"

Example

json

aeo_update_folder({
  folder_id: class="code-string">"fld-ghi-789",
  name: class="code-string">"NY CDPAP Eligibility",
  description: class="code-string">"Updated scope: enrollment + eligibility"
})

Example Response

response

{
  class="code-string">"folder_id": class="code-string">"fld-ghi-789",
  class="code-string">"updated_fields": {
    class="code-string">"name": class="code-string">"NY CDPAP Eligibility",
    class="code-string">"description": class="code-string">"Updated scope: enrollment + eligibility"
  }
}

aeo_move_article

Move an article to a different folder. Use this to reorganize content across the project hierarchy without re-creating the article. The article retains all its content and metadata - only its folder assignment changes.

Parameters

Name	Type	Required	Description
`execution_id`	string	Required	Pipeline execution ID of the article to move
`folder_id`	string	Required	Target folder UUID

Example

json

aeo_move_article({
  execution_id: class="code-string">"exec-xyz-001",
  folder_id: class="code-string">"fld-ghi-789"
})

Example Response

response

{
  class="code-string">"message": class="code-string">"Article moved successfully",
  class="code-string">"execution_id": class="code-string">"exec-xyz-001",
  class="code-string">"folder_id": class="code-string">"fld-ghi-789"
}

Typical workflow: aeo_create_project → aeo_create_group → aeo_create_folder → save articles → use aeo_move_article to reorganize as the cluster evolves. Use aeo_list_projects at any time to see the full tree.