Find Project Portfolio Streams

Description

Lists the AttackForge Portfolio Streams linked to one project, one row per stream together with the portfolio it belongs to. Linking a stream to a project places the project and its assets in that stream. Use this to read the project's current links before changing them with patch_project_portfolio_streams - call find_portfolio_streams to discover streams that are not linked yet. Streams of archived portfolios are listed too, marked with portfolio_archived.

Requires the Portfolios module to be enabled; otherwise returns the error Portfolios module is not enabled. The caller must have at least View access to the project, and sees only the linked streams whose stream and portfolio they can both view; can_link tells whether the caller may unlink the stream, and link it unless its portfolio is archived. Results are ordered by portfolio id, then stream id, and paginated (default 10 per page, max 50).

How To Enable

1. Go to Users

2. Select the user you would like to provide access to this tool

3. Click on Access > MCP

4. Click on Add Tools

5. Select the tool find_project_portfolio_streams and click Add

Example Prompts

• Which portfolio streams is project X linked to?

• Is the ACME project in the EMEA Web Applications stream?

• Which of this project's streams am I allowed to unlink?

Parameters

Parameter	Type	Required	Description
project_id	string	Yes	The id (24-hex) of the project whose linked portfolio streams you want to list. Obtain it from find_projects. The caller must have View access or higher.
limit	integer	No	Maximum records to return in this page. Default 10, max 50.
skip	integer	No	Number of records to skip (offset). Default 0.

Returned fields:

Field	Type	Description
portfolio_id	string	the portfolio id
portfolio_name	string	the portfolio name
stream_id	string	the stream id
stream_name	string	the stream name
can_link	boolean	true when the caller may unlink this stream, and link it to a project unless portfolio_archived (the pair is then listed by find_portfolio_streams)
portfolio_archived	boolean	true when the stream's portfolio is archived. Such a stream cannot be linked to a project, but can be unlinked when can_link is true

portfolio_id and stream_id together are the pair patch_project_portfolio_streams takes to unlink the stream. Every row carries them, can_link and portfolio_archived; a name that is empty is left out.

Example Response

{
  "data": [
    {
      "portfolio_id": "65c2a1d48cade68ca7bc7301",
      "portfolio_name": "Cloud Security",
      "stream_id": "65c2a1e98cade68ca7bc7314",
      "stream_name": "EMEA Web Applications",
      "can_link": true,
      "portfolio_archived": false
    }
  ],
  "count": 1,
  "total": 1
}