SonarQube & SonarCloud MCP Server for Mastra AI 10 tools — connect in under 2 minutes
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect SonarQube & SonarCloud through the Vinkius and Mastra agents discover all tools automatically — type-safe, streaming-ready, and deployable anywhere Node.js runs.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token — get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"sonarqube-sonarcloud": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "SonarQube & SonarCloud Agent",
instructions:
"You help users interact with SonarQube & SonarCloud " +
"using 10 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with SonarQube & SonarCloud?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About SonarQube & SonarCloud MCP Server
Connect your self-hosted SonarQube instances or SonarCloud dashboards directly to your preferred AI agent. Speed up your DevSecOps workflow by diagnosing and investigating static code vulnerabilities via natural language. Rather than jumping between browser tabs trying to locate a specific Code Smell or Security Hotspot, query your organizational technical debt footprint dynamically through MCP.
Mastra's agent abstraction provides a clean separation between LLM logic and SonarQube & SonarCloud tool infrastructure. Connect 10 tools through the Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution — deployable to any Node.js host in one command.
What you can do
- Quality Gate Verification — Stop bad commits before they happen. Ask your AI to
get_quality_gate_statuson your target project and pull KPIs like unit test coverage usingget_measures - Vulnerability Hunting — Expose specific codebase flaws instantly with
search_issuesfiltering by severity (Critical, Blocker, Major) - Deep Code Insight — Retrieve entire directories and component hierarchies calling
get_component_treeand fetch raw annotated source code throughget_source_code - Security & Rules — Consult your enabled analysis rules directly via
list_rulesand audit manual-reviewget_hotspotson your main server
The SonarQube & SonarCloud MCP Server exposes 10 tools through the Vinkius. Connect it to Mastra AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect SonarQube & SonarCloud to Mastra AI via MCP
Follow these steps to integrate the SonarQube & SonarCloud MCP Server with Mastra AI.
Install dependencies
Run npm install @mastra/core @mastra/mcp @ai-sdk/openai
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Run the agent
Save to agent.ts and run with npx tsx agent.ts
Explore tools
Mastra discovers 10 tools from SonarQube & SonarCloud via MCP
Why Use Mastra AI with the SonarQube & SonarCloud MCP Server
Mastra AI provides unique advantages when paired with SonarQube & SonarCloud through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure — add SonarQube & SonarCloud without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every SonarQube & SonarCloud tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host — Vercel, Railway, Fly.io, or your own infrastructure
SonarQube & SonarCloud + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the SonarQube & SonarCloud MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query SonarQube & SonarCloud, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed SonarQube & SonarCloud as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query SonarQube & SonarCloud on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using SonarQube & SonarCloud tools alongside other MCP servers
SonarQube & SonarCloud MCP Tools for Mastra AI (10)
These 10 tools become available when you connect SonarQube & SonarCloud to Mastra AI via MCP:
get_component_tree
Get the component tree (files/directories) of a SonarQube project with metrics
get_duplications
Get code duplication blocks for a file in SonarQube
get_hotspots
Get security hotspots for a SonarQube project
get_measures
Requires project key and comma-separated metric keys. Get code quality measures/metrics for a SonarQube project
get_quality_gate_status
Get the quality gate status for a SonarQube project
get_source_code
Get annotated source code lines from SonarQube for a file
list_quality_gates
List all quality gate definitions in SonarQube
list_rules
Can filter by language. List SonarQube analysis rules
search_issues
Filter by project key and optional severities. Search code issues in a SonarQube/SonarCloud project
search_projects
Returns project keys and names. Project keys are required for most other tools. Search projects on SonarQube/SonarCloud
Example Prompts for SonarQube & SonarCloud in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with SonarQube & SonarCloud immediately.
"Search our primary repository and give me the official Quality Gate diagnostic."
"Run a test coverage and technical debt measure retrieval on all core services."
"Tell me the precise component lines hitting security hotspot alerts."
Troubleshooting SonarQube & SonarCloud MCP Server with Mastra AI
Common issues when connecting SonarQube & SonarCloud to Mastra AI through the Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpSonarQube & SonarCloud + Mastra AI FAQ
Common questions about integrating SonarQube & SonarCloud MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Connect SonarQube & SonarCloud with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect SonarQube & SonarCloud to Mastra AI
Get your token, paste the configuration, and start using 10 tools in under 2 minutes. No API key management needed.