Projects

create_project

Create a new project for organizing content and context into a workstream. Optionally generates a project brief document in the same call.

Parameters

Name	Type	Required	Default	Description
`name`	`string`	Yes	—	Project name
`visibility`	`string`	No	team	Team visibility
`project_brief_details`	`string`	No	—	Optional details to create a project brief.

Input Schema

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Project name."
    },
    "visibility": {
      "enum": [
        "team",
        "private"
      ],
      "type": "string",
      "default": "team",
      "description": "team or private. Defaults to team."
    },
    "project_brief_details": {
      "type": "string",
      "minLength": 1,
      "description": "If supplied, an AI-generated project brief is created and attached to the project. The brief's content_id is returned in the response so it can be passed to update_content later for edits."
    }
  }
}

Output Schema

{
  "type": "object",
  "required": [
    "project_id",
    "name",
    "link_url"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Project name."
    },
    "link_url": {
      "type": "string",
      "description": "Direct URL to view this project in Marcora."
    },
    "project_id": {
      "type": "string",
      "format": "uuid",
      "description": "Project identifier."
    },
    "project_brief": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "name": {
          "type": "string"
        },
        "content_id": {
          "type": "string",
          "format": "uuid"
        }
      },
      "description": "Present (non-null) only when project_brief_details was supplied. {name, content_id}. content_id is the canvas UUID — pass it to update_content / get_content to edit or read the brief. name may be empty immediately after creation while AI generation is in flight."
    }
  }
}

Instructions

Create a new project for organizing content and context into a workstream. Optionally generates a project brief document in the same call.

Example prompts

"Create a project for our Q3 product launch"
"Start a new project called 'Brand Refresh 2025'"
"Create a project for our Acme deal with a brief covering the customer's stack and pain points"