Find Portfolio Streams

Description

Lists the AttackForge Portfolio Streams the caller may link to a project, one row per stream together with the portfolio it belongs to. A portfolio is divided into streams, and linking a stream to a project places the project and its assets in that stream. Use this to discover the portfolio_id and stream_id pairs patch_project_portfolio_streams and create_project take - call find_project_portfolio_streams instead to see which streams a project is already linked to.

Requires the Portfolios module to be enabled; otherwise returns the error Portfolios module is not enabled. Admins see every stream of every portfolio that is not archived; other callers see only the streams they have link access to, through the stream or its portfolio. 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_portfolio_streams and click Add

Example Prompts

• Which portfolio streams can I link projects to?

• List the streams of the Cloud Security portfolio.

• Which stream should I link project X to for the EMEA web applications?

Parameters

Parameter	Type	Required	Description
portfolio_id	string	No	Id (24-hex) of a portfolio. When given, only the streams of this portfolio are listed.
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 - use with patch_project_portfolio_streams
portfolio_name	string	the portfolio name
stream_id	string	the stream id - use with patch_project_portfolio_streams
stream_name	string	the stream name

Every row carries portfolio_id and stream_id; 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"
    }
  ],
  "count": 1,
  "total": 1
}