search
Full-text search across work items, comments, projects, labels, and users (ranked, permission-scoped) — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:read permission).
Full-text search across work items, comments, projects, labels, and users (ranked, permission-scoped).
| Required permission | work:read |
| Capability ID | search.query |
| Destructive | No |
Parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
q | string | yes | |
types | string | no | |
limit | integer | no |
Input schema (JSON Schema)
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"types": {
"type": "string"
},
"limit": {
"type": "integer",
"minimum": 0,
"maximum": 50,
"default": 20
}
},
"required": [
"q"
],
"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.
save_view
Save a view (filter AST + sort + grouping + layout; personal or shared) — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:write permission).
set_active_workspace
Set the active workspace for the session/principal — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the workspace:read permission).