# Feature AI-9 - Provide initial set of MCP Tools

Project: Stream AI
Status: closed
URL: https://community.openproject.org/work_packages/AI-9

## Planning

| Attribute | Value |
| --- | --- |
| Date |  |
| Priority | Medium |
| Target versions | 17.2.0 |
| List |  |
| Roadmap |  |
| Relevance |  |

## OPEN POINTS / FEEDBACK

_No work packages_

## Features and Chunks

| ID | Subject | Type | Status | Assignee | Target versions | Spent time |
| --- | --- | --- | --- | --- | --- | --- |
| AI-22 | Implement searchProject tool | Implementation | closed |  |  |  |
| AI-23 | Implement searchWorkPackage tool | Implementation | closed |  |  |  |
| AI-27 | Allow to paginate tool results | Implementation | closed |  |  |  |
| AI-29 | Tool: search_users | Implementation | closed |  |  |  |
| AI-30 | Tool: search_versions | Implementation | closed |  |  |  |
| AI-35 | Tool: search_programs | Implementation | closed |  |  |  |
| AI-36 | Tool: search_portfolios | Implementation | closed |  |  |  |

## Bugs and other work packages

| ID | Type | Subject | Status | Assignee | Target versions | Spent time | Module |
| --- | --- | --- | --- | --- | --- | --- | --- |
| AI-21 | Code maintenance | Make current API schemas usable by code | closed |  |  |  |  |

## Technical Details

| Attribute | Value |
| --- | --- |
| Module | Artificial Intelligence / MCP Server (MCP) |
| Feature Flag |  |
| Requires doc change | No |
| Enterprise plan |  |

## Details

| Attribute | Value |
| --- | --- |
| Pull preview |  |
| Mockups |  |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable |  |
| Product manager |  |
| Developers |  |
| Designer |  |
| Ordered by |  |
| Signed off by |  |
| Interest by |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| Work |  |
| Labor costs |  |

## Description

**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**

*   The following tools are available:
    
    *   **searchProject:** filters projects by attributes such as name, identifier, or status.
        
    *   **searchProgram:** filters programs by attributes such as name, identifier, or status.
        
    *   **searchPortfolio:** filters portfolios by attributes such as name, identifier, or status.
        
    *   **searchWorkPackage:** filters by attributes such as subject, project, status, type, version, and user.
        
    *   **searchVersion**
        
    *   **searchUser**
        
*   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>