sonar-list-projects

name	sonar-list-projects
description	List SonarQube projects accessible to the current user via the SonarQube MCP Server
argument-hint	[search-query] [--page n] [--page-size n]

SonarQube — List Projects

List SonarQube projects accessible to the authenticated user. Useful for discovering project keys before running other skills.

Usage

sonar-list-projects                      # list accessible projects
sonar-list-projects my-project           # search by name (partial) or key (exact)
sonar-list-projects --page 2             # next page of results
sonar-list-projects --page-size 100      # limit page size

Prerequisites

This skill requires the SonarQube MCP Server to be configured and the tool mcp__sonarqube__search_my_sonarqube_projects to be available in your session.

If the tool call fails, surface the tool error verbatim and stop. Auth, credentials, and MCP server configuration are runtime infrastructure concerns and are not user-fixable from chat — do not ask the user to verify env vars or to install or run any CLI.

Instructions

Step 1: Parse arguments

• The first non-flag argument (if present) is the search term and maps to q.
• --page <n> maps to page (string, defaults to 1).
• --page-size <n> maps to pageSize (integer 1–500, defaults to 500).

Step 2: Validate arguments

Argument	Allowed pattern / values
search term	^[a-zA-Z0-9_\-\. ]+$
--page	positive integer
--page-size	integer 1–500

If a value fails validation, stop and tell the user what was rejected — do not run the call.

Step 3: Call mcp__sonarqube__search_my_sonarqube_projects

{
  "q": "<search-term>",
  "page": "<n>",
  "pageSize": <n>
}

Omit any field the user did not provide.

Step 4: Format the results

If projects are found:

## SonarQube Projects

Found **8 project(s)**:

| Project key       | Name            |
| ----------------- | --------------- |
| my-org_backend    | Backend Service |
| my-org_frontend   | Frontend App    |
| my-org_shared-lib | Shared Library  |

If no projects are found:

## SonarQube Projects

No projects found.

If more results are likely (response is full to pageSize): "Showing page N. Use --page <n+1> to see more, or pass a search term to narrow results."

Step 5: Next steps

• To list issues: "Invoke the sonar-list-issues skill with the project key, or rely on the MCP integration default."
• To check the quality gate: "Invoke the sonar-quality-gate skill — add a project key only if you are not using the MCP integration default."