RyTask docs
MCP tools

list_projects

List accessible projects in the workspace (keyset paginated) — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:read permission).

View as MarkdownOpen in ChatGPTOpen in Claude

List accessible projects in the workspace (keyset paginated).

Required permissionwork:read
Capability IDprojects.list
DestructiveNo

Parameters

ParameterTypeRequiredNotes
filterstringno
limitintegerno
cursorstringno
fieldsarray of stringno

Input schema (JSON Schema)

{
  "type": "object",
  "properties": {
    "filter": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 50
    },
    "cursor": {
      "type": "string"
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "additionalProperties": false
}

Access control

A call succeeds only when the personal access token's scopes and the holder's role both allow work:read (effective permission = scope ∩ role, default-deny). The tool runs inside the token owner's organization — tenancy is never a parameter.

On this page