Content
View differences
Updated by Jan Sandbrink about 5 hours ago
**As** an AI assistant or MCP client
**I want to** search for projects and work packages using standard filters
**so that** I can identify relevant entities before taking further actions
**Acceptance criteria**
* Two tools are available:
* **searchProject:** filters projects by attributes such as name, identifier, or status.
* **searchWorkPackage:** filters by attributes such as subject, project, status, type, version, and user.
* In case finding by name does not work well for resources, additionally **resolveUser** and **resolveVersion** needs to be available
* Each tool supports multiple filters (AND logic).
* Results include IDs and key attributes needed for subsequent actions.
* Support cursor-based pagination
<br>
**Technical notes**
* Backed by standard OpenProject models and APIv3 query scopes.
* Implemented as MCP “tools” returning structured JSON arrays.
* Uses pagination for large result sets.
<br>
**Permissions and visibility considerations**
* Visible to all users with permission to view the relevant projects or work packages.
* Hidden for anonymous users or when the MCP feature is disabled.
<br>
**I want to** search for projects and work packages using standard filters
**so that** I can identify relevant entities before taking further actions
**Acceptance criteria**
* Two tools are available:
* **searchProject:** filters projects by attributes such as name, identifier, or status.
* **searchWorkPackage:** filters by attributes such as subject, project, status, type, version, and user.
* In case finding by name does not work well for resources, additionally **resolveUser** and **resolveVersion** needs to be available
* Each tool supports multiple filters (AND logic).
* Results include IDs and key attributes needed for subsequent actions.
* Support cursor-based pagination
<br>
**Technical notes**
* Backed by standard OpenProject models and APIv3 query scopes.
* Implemented as MCP “tools” returning structured JSON arrays.
* Uses pagination for large result sets.
<br>
**Permissions and visibility considerations**
* Visible to all users with permission to view the relevant projects or work packages.
* Hidden for anonymous users or when the MCP feature is disabled.
<br>