MCP tools

project_update write

Rename a project, change its lead, or archive and unarchive it (archiving is an admin call; an archived project takes no new issues and its existing ones stay readable), or set how agents finish work here: agent_done, one of review, allowed and proof, and done_criteria, the markdown a refusal quotes to the agent it turned away. The key cannot be changed: it is the prefix of every issue key in the project.

Arguments

NameTypeDescription
agent_donenull | stringset the agent completion policy: review, allowed, or proof One of review, allowed, proof.
archivednull | booleanarchive or unarchive. An archived project takes no new issues, and its existing ones stay readable and searchable
clear_done_criteriabooleanremove the done criteria; omitting done_criteria leaves it unchanged
clear_leadbooleanremove the lead; omitting lead_id leaves it unchanged
clear_target_datebooleanremove the due date; omitting target_date leaves it unchanged
done_criterianull | stringset the markdown describing what finishing work means for this project
keynull | stringrejected if it differs from the current key: a project key is immutable once set
lead_idnull | stringULID of the new lead; read roadmap://users
namenull | stringa new display name
project requiredstringa project key like ENG, or a ULID
target_datenull | stringa new due date as YYYY-MM-DD

Input schema

Exactly what tools/list serves.

input schema
{
  "additionalproperties": false,
  "properties": {
    "agent_done": {
      "description": "set the agent completion policy: review, allowed, or proof",
      "enum": [
        "review",
        "allowed",
        "proof"
      ],
      "type": [
        "null",
        "string"
      ]
    },
    "archived": {
      "description": "archive or unarchive. An archived project takes no new issues, and its existing ones stay readable and searchable",
      "type": [
        "null",
        "boolean"
      ]
    },
    "clear_done_criteria": {
      "description": "remove the done criteria; omitting done_criteria leaves it unchanged",
      "type": "boolean"
    },
    "clear_lead": {
      "description": "remove the lead; omitting lead_id leaves it unchanged",
      "type": "boolean"
    },
    "clear_target_date": {
      "description": "remove the due date; omitting target_date leaves it unchanged",
      "type": "boolean"
    },
    "done_criteria": {
      "description": "set the markdown describing what finishing work means for this project",
      "type": [
        "null",
        "string"
      ]
    },
    "key": {
      "description": "rejected if it differs from the current key: a project key is immutable once set",
      "type": [
        "null",
        "string"
      ]
    },
    "lead_id": {
      "description": "ULID of the new lead; read roadmap://users",
      "type": [
        "null",
        "string"
      ]
    },
    "name": {
      "description": "a new display name",
      "type": [
        "null",
        "string"
      ]
    },
    "project": {
      "description": "a project key like ENG, or a ULID",
      "type": "string"
    },
    "target_date": {
      "description": "a new due date as YYYY-MM-DD",
      "type": [
        "null",
        "string"
      ]
    }
  },
  "required": [
    "project"
  ],
  "type": "object"
}