create_project
Create a project (seeds default statuses + key counter + creator membership) — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:write permission).
Create a project (seeds default statuses + key counter + creator membership).
| Required permission | work:write |
| Capability ID | projects.create |
| Destructive | No |
Parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
name | string | yes | |
keyPrefix | string | yes | |
description | string | no | |
icon | string | no | |
color | string | no | |
leadId | string (uuid) | no |
Input schema (JSON Schema)
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"keyPrefix": {
"type": "string",
"pattern": "/^[A-Z][A-Z0-9]{1,9}$/"
},
"description": {
"type": "string",
"maxLength": 2000
},
"icon": {
"type": "string",
"maxLength": 64
},
"color": {
"type": "string",
"minLength": 1,
"maxLength": 32
},
"leadId": {
"type": "string",
"format": "uuid"
}
},
"required": [
"name",
"keyPrefix"
],
"additionalProperties": false
}Access control
A call succeeds only when the personal access token's scopes and the holder's role both allow work:write (effective permission = scope ∩ role, default-deny). The tool runs inside the token owner's organization — tenancy is never a parameter.
create_label
Create a workspace label — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:write permission).
create_status
Add a status to a project (mapped to a fixed category) — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:write permission).