MCP tools

project_create write

Create a project, the top of the tree. The key is what every issue in it will be named after (ENG becomes ENG-1, ENG-2), and it cannot be changed afterwards. Only an admin may create one. Set agent_done at creation: review, the default, refuses a token change setting done or canceled with agent_done_not_allowed (set in_review instead); allowed lets a token set either; proof requires a proof object on the finishing change. done_criteria is the markdown describing what finishing work means for this project, and the refusal quotes it, so write it before agents start.

Arguments

NameTypeDescription
agent_donestringthe project's agent completion policy. review: a token cannot set done or canceled. allowed: a token may set either. proof: a token must attach a proof object to finish work One of review, allowed, proof.
done_criteriastringmarkdown describing what finishing work means for this project; quoted back to an agent refused under the review policy
key requiredstringa short uppercase key like ENG: one letter then 1 to 5 letters or digits. Immutable once set, because it appears in every issue key
lead_idnull | stringULID of the user who leads the project; read roadmap://users
name requiredstringthe project's display name
target_datestringwhen the project is due, as a calendar date YYYY-MM-DD such as 2026-09-01. No time and no timezone. Optional, and in no enforced order with its milestones' dates

Input schema

Exactly what tools/list serves.

input schema
{
  "additionalproperties": false,
  "properties": {
    "agent_done": {
      "description": "the project's agent completion policy. review: a token cannot set done or canceled. allowed: a token may set either. proof: a token must attach a proof object to finish work",
      "enum": [
        "review",
        "allowed",
        "proof"
      ],
      "type": "string"
    },
    "done_criteria": {
      "description": "markdown describing what finishing work means for this project; quoted back to an agent refused under the review policy",
      "type": "string"
    },
    "key": {
      "description": "a short uppercase key like ENG: one letter then 1 to 5 letters or digits. Immutable once set, because it appears in every issue key",
      "type": "string"
    },
    "lead_id": {
      "description": "ULID of the user who leads the project; read roadmap://users",
      "type": [
        "null",
        "string"
      ]
    },
    "name": {
      "description": "the project's display name",
      "type": "string"
    },
    "target_date": {
      "description": "when the project is due, as a calendar date YYYY-MM-DD such as 2026-09-01. No time and no timezone. Optional, and in no enforced order with its milestones' dates",
      "type": "string"
    }
  },
  "required": [
    "key",
    "name"
  ],
  "type": "object"
}