blackduck-polaris-mcp-server
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@blackduck-polaris-mcp-servertrigger a SAST scan on the main branch"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
blackduck-polaris-mcp-server
The most comprehensive MCP (Model Context Protocol) server for Black Duck Polaris. Trigger SAST/SCA/DAST scans, query findings, triage issues, generate and download reports (SBOM, SPDX, CycloneDX), manage policies, and more — all from your AI coding assistant.
Works With
Claude Code | Claude Desktop | GitHub Copilot | Copilot CLI | OpenCode | Cursor | Windsurf | VS Code (MCP extensions) | any MCP-compatible AI tool
Quick Start
Prerequisites
You need a Polaris API token. Generate one at Profile > Account > Access Tokens in your Polaris instance.
Claude Code
claude mcp add blackduck-polaris -e POLARIS_URL=https://your-instance.polaris.blackduck.com -e POLARIS_API_TOKEN=your-token -- npx blackduck-polaris-mcp-serverClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"blackduck-polaris": {
"command": "npx",
"args": ["blackduck-polaris-mcp-server"],
"env": {
"POLARIS_URL": "https://your-instance.polaris.blackduck.com",
"POLARIS_API_TOKEN": "your-token"
}
}
}
}VS Code (.vscode/mcp.json)
{
"servers": {
"blackduck-polaris": {
"type": "stdio",
"command": "npx",
"args": ["-y", "blackduck-polaris-mcp-server"],
"env": {
"POLARIS_URL": "https://your-instance.polaris.blackduck.com",
"POLARIS_API_TOKEN": "your-token"
}
}
}
}Cursor (.cursor/mcp.json or ~/.cursor/mcp.json)
{
"mcpServers": {
"blackduck-polaris": {
"command": "npx",
"args": ["-y", "blackduck-polaris-mcp-server"],
"env": {
"POLARIS_URL": "https://your-instance.polaris.blackduck.com",
"POLARIS_API_TOKEN": "your-token"
}
}
}
}GitHub Copilot CLI
Option 1 — Config file (~/.copilot/mcp-config.json):
{
"mcpServers": {
"blackduck-polaris": {
"type": "local",
"command": "npx",
"args": ["blackduck-polaris-mcp-server"],
"env": {
"POLARIS_URL": "https://your-instance.polaris.blackduck.com",
"POLARIS_API_TOKEN": "your-token"
}
}
}
}Option 2 — Inline for a single session:
copilot --additional-mcp-config '{"blackduck-polaris":{"type":"local","command":"npx","args":["blackduck-polaris-mcp-server"],"env":{"POLARIS_URL":"https://your-instance.polaris.blackduck.com","POLARIS_API_TOKEN":"your-token"}}}'OpenCode
Option 1 — Interactive: Run opencode mcp add and follow the prompts.
Option 2 — Config file (~/.config/opencode/opencode.json or opencode.json in project root):
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"blackduck-polaris": {
"type": "local",
"enabled": true,
"command": ["npx", "-y", "blackduck-polaris-mcp-server"],
"environment": {
"POLARIS_URL": "https://your-instance.polaris.blackduck.com",
"POLARIS_API_TOKEN": "your-token"
}
}
}
}Features — 66 Tools Across 10 Domains
Portfolio Navigation (8 tools)
Tool | Description |
| List all portfolios |
| List applications in a portfolio |
| Create new application |
| Update application |
| Delete application |
| List projects in an application |
| Create new project |
| List branches in a project |
Findings & Triage (10 tools)
Tool | Description |
| Query issues with RSQL filter (severity, tool, CWE, status) |
| Get full issue details |
| View triage audit trail |
| View detection change history |
| Dismiss, change severity, assign, update status |
| List issue occurrences with filter |
| Get vulnerable source code snippet |
| AI-assisted remediation guidance (Black Duck Assist) |
| Feedback on AI remediation quality |
| Aggregated issue counts by severity/type |
Scans / Test Management (8 tools)
Tool | Description |
| Trigger SAST/SCA/DAST scan on a branch |
| List scans with filter |
| Get scan status (QUEUED, RUNNING, COMPLETED, FAILED) |
| Cancel a running scan |
| Issue counts and metrics for a scan |
| Get scan comments |
| List scan artifacts |
| Upload artifact for external analysis |
Reports (6 tools)
Tool | Description |
| List all report types |
| Generate report (SBOM, SPDX, CycloneDX, executive summary, etc.) |
| List generated reports |
| Check report generation status |
| Download completed report |
| Delete a report |
Supported report types: Developer Detail SCA, Developer Detail Static, Developer Detail Dynamic, Executive Summary, Issue Overview, Issue Summary, Security Audit, SBOM, SPDX v2.3, CycloneDX v1.4, CycloneDX v1.6, Standard Compliance, Standard Compliance Detail, Test Summary
Policies (7 tools)
Tool | Description |
| List issue policies |
| Create policy (build break, email, Jira ticket) |
| Update policy |
| Delete policy |
| List test scheduling policies |
| Create automated scan schedule |
| Assign policy to project/application/branch |
SCM / Repository Integration (7 tools)
Tool | Description |
| List connected repositories |
| Get repository details |
| Update repository settings |
| List repository branches |
| Test SCM connectivity |
| Bulk import repos from SCM |
| List supported SCM providers |
Bug Tracking Integration (5 tools)
Tool | Description |
| List Jira/Azure DevOps configurations |
| Create bug tracker integration |
| Update integration config |
| Export issues to Jira/Azure DevOps |
| Test Jira connectivity |
Audit (3 tools)
Tool | Description |
| Query audit logs (category, user, date range) |
| Export audit logs as CSV |
| List audit event categories |
Identity & Access Management (9 tools)
Tool | Description |
| List organization users |
| Create user |
| Get user details |
| Update user role/details |
| List groups |
| Create group |
| Get authenticated user info |
| Create API token |
| Create service account token |
Notifications (3 tools)
Tool | Description |
| Get org notification preferences |
| Update notification preferences |
| Get user event subscriptions |
Example Workflows
Scan a branch and review findings
You: Trigger a SAST and SCA scan on the main branch of project X
AI: [calls polaris_trigger_scan] Scan triggered, test ID: abc-123
You: Check the scan status
AI: [calls polaris_get_test] Status: COMPLETED. 12 new issues found.
You: Show me the critical issues
AI: [calls polaris_list_issues with severity filter] Found 3 critical issues...
You: Show me the code for the first one
AI: [calls polaris_get_occurrence_snippet] Here's the vulnerable code at line 42...
You: Get remediation advice
AI: [calls polaris_get_remediation] Black Duck Assist suggests...Generate a compliance report
You: Generate an SPDX report for application Y
AI: [calls polaris_generate_report] Report queued, ID: rpt-456
You: Is it ready?
AI: [calls polaris_get_report_status] Status: COMPLETED
You: Download it
AI: [calls polaris_download_report] Here's your SPDX v2.3 report...Export issues to Jira
You: Show me all high-severity SAST issues
AI: [calls polaris_list_issues] Found 8 high-severity SAST issues
You: Export the first 3 to Jira
AI: [calls polaris_export_issues_to_tracker] 3 issues exported to JiraEnvironment Variables
Variable | Required | Description |
| Yes | Your Polaris instance URL (e.g., |
| Yes | API token from Profile > Account > Access Tokens |
Development
git clone https://github.com/your-username/blackduck-polaris-mcp-server.git
cd blackduck-polaris-mcp-server
npm install
npm run build
npm startTesting with MCP Inspector
POLARIS_URL=https://... POLARIS_API_TOKEN=... npx @modelcontextprotocol/inspector node build/index.jsLicense
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/easygoingcoder/blackduck-polaris-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server