# About the MCP Server

The SonarQube MCP Server gives your AI coding agent access to SonarQube's code quality and security data. It's a tool bag: a set of tools your agent can call to analyze code, retrieve issues, check quality gates, inspect security hotspots, measure coverage, and more.

It works with [Claude Code](/agent-centric-development-cycle/developer-tools/mcp-server/setup/quickstart-guides/claude-code.md), [Codex CLI](/agent-centric-development-cycle/developer-tools/mcp-server/setup/quickstart-guides/codex-cli.md), [Cursor](/agent-centric-development-cycle/developer-tools/mcp-server/setup/quickstart-guides/cursor.md), [Gemini CLI](/agent-centric-development-cycle/developer-tools/mcp-server/setup/quickstart-guides/gemini-cli.md), [GitHub Copilot CLI](/agent-centric-development-cycle/developer-tools/mcp-server/setup/quickstart-guides/github-copilot-cli.md), [GitHub Copilot Cloud Agent](/agent-centric-development-cycle/developer-tools/mcp-server/setup/quickstart-guides/github-copilot-cloud-agent.md), [Kiro](/agent-centric-development-cycle/developer-tools/mcp-server/setup/quickstart-guides/kiro.md), [VS Code](/agent-centric-development-cycle/developer-tools/mcp-server/setup/quickstart-guides/vs-code.md), [Windsurf](/agent-centric-development-cycle/developer-tools/mcp-server/setup/quickstart-guides/windsurf.md), and [Zed](/agent-centric-development-cycle/developer-tools/mcp-server/setup/quickstart-guides/zed.md).

<figure><img src="/spaces/KXW79zfYFiA8incTvwZK/files/1aQsVxN4965WbY8uLZ5w" alt="Overview of the SonarQube MCP Server setup."><figcaption></figcaption></figure>

## Tools

The server exposes tools in these categories:

* [Analysis](/agent-centric-development-cycle/developer-tools/mcp-server/reference/tools.md#analysis): analyze code snippets or files directly in the agent context
* [Issues](/agent-centric-development-cycle/developer-tools/mcp-server/reference/tools.md#issues): search, review, and update code issues
* [Quality gates](/agent-centric-development-cycle/developer-tools/mcp-server/reference/tools.md#quality-gates): check quality gate status for a project
* [Security Hotspots](/agent-centric-development-cycle/developer-tools/mcp-server/reference/tools.md#security-hotspots): search and review security hotspots
* [Coverage](/agent-centric-development-cycle/developer-tools/mcp-server/reference/tools.md#coverage): find under-covered files and get line-by-line coverage details
* [Projects](/agent-centric-development-cycle/developer-tools/mcp-server/reference/tools.md#projects): search projects and pull requests
* [Dependency risks](/agent-centric-development-cycle/developer-tools/mcp-server/reference/tools.md#dependency-risks): SCA issues found in a project
* [Context Augmentation](/agent-centric-development-cycle/developer-tools/mcp-server/reference/tools.md#context-augmentation): code architecture search, call flows, coding guidelines, and SCA dependency checks (SonarQube Cloud)

See the [Tools](/agent-centric-development-cycle/developer-tools/mcp-server/reference/tools.md) page for the full reference.

Some tools require SonarQube Cloud add-ons: [Agentic Analysis](broken://spaces/B4UT2GNiZKjtxFtcFAL7/pages/qgppt3o9gx8Tnf8MWstN) and [Context Augmentation](broken://spaces/B4UT2GNiZKjtxFtcFAL7/pages/f8tcVKNsgGVuKZ5IKCp9).

## Data and telemetry

The SonarQube MCP Server collects anonymous usage data and sends it to Sonar to help improve the product. Sonar doesn't collect your IP address, your source code, or share data with anyone else.

Collection of telemetry can be disabled with: `TELEMETRY_DISABLED=true`. For a sample of the data collected, see [telemetry-sample.md](https://github.com/SonarSource/sonarqube-mcp-server/blob/master/telemetry-sample.md) in the source repository.

## License

Licensed under the [SONAR Source-Available License v1.0](https://www.sonarsource.com/license/ssal/). Using the SonarQube MCP Server in compliance with this documentation is a Non-Competitive Purpose and so is allowed under the SSAL.

Your use of SonarQube via MCP is governed by the [SonarQube Cloud Terms of Service](https://www.sonarsource.com/legal/sonarcloud/terms-of-service/) or [SonarQube Server Terms and Conditions](https://www.sonarsource.com/legal/sonarqube/terms-and-conditions/), including use of the Results Data solely for your internal software development purposes.

## Next steps

Read the [Environment considerations](/agent-centric-development-cycle/developer-tools/mcp-server/setup/environment-considerations.md) to find the setup that matches your needs and follow the [quickstart guides](/agent-centric-development-cycle/developer-tools/mcp-server/setup/quickstart-guides.md) to quickly get started with your favorite IDE or CLI.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sonarsource.com/agent-centric-development-cycle/developer-tools/mcp-server/about-the-mcp-server.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
