The Contrast MCP Server connects Contrast Security to your AI coding agent so you can remediate vulnerabilities, update insecure libraries, and analyze security coverage through natural language.
It comes in two forms.
is a remote MCP server that Contrast runs for you. It is the simplest path for Contrast SaaS customers, with browser-based OAuth sign-in and nothing to install.
Local MCP Server is the open-source server in this repository that you run yourself with API keys. It is the right choice for on-premises and EOP (Enterprise On-Premises) instances.
[!WARNING]
CRITICAL SECURITY WARNING: Exposing Contrast vulnerability data to an AI service that trains on your prompts can leak sensitive information. Only use the Contrast MCP Server with environments that contractually guarantee data isolation and prohibit model training on your inputs.
Verify AI Data Privacy: Confirm that your service agreement prevents model training on your prompts and consult your security team before sharing Contrast data.
UNSAFE: Public consumer LLM sites (e.g., free ChatGPT, Gemini, Claude) that use prompts for training.
POTENTIALLY SAFE: Enterprise services with contractual privacy guarantees (e.g., Google Cloud AI, AWS Bedrock, Azure OpenAI).
The Hosted MCP Server, a remote MCP server that Contrast operates for you, is the easiest way to connect an AI agent to Contrast. You point your client at one URL, sign in through your browser, and your agent can start asking questions about your security data. There are no API keys to copy around, no container or JAR to keep updated, and no local process to run.
The hosted server is read-only and is available now for Contrast SaaS.
Prerequisites
A Contrast SaaS account with access to at least one organization
An MCP client that supports Streamable HTTP transport and OAuth 2.0 with PKCE (see Supported clients)
A modern web browser for the OAuth sign-in
Connect
Add the server to Claude Code by pointing it at your Contrast host followed by /mcp.
claude mcp add --transport http contrast-hosted-mcp https://app.contrastsecurity.com/mcp
Replace app.contrastsecurity.com with your organization's Contrast URL if you use a dedicated instance. The first time your agent calls a tool, your browser opens for sign-in. If sign-in does not start automatically, run /mcp in Claude Code and choose Authenticate for contrast-hosted-mcp. You log in with your existing Contrast credentials, choose an organization, and approve read access. Your session refreshes on its own, so you typically sign in once and keep working.
For step-by-step setup for Claude Code, Claude Desktop, the Codex CLI, the GitHub Copilot CLI, and opencode, see the Hosted MCP Server installation guide.
Connection details
Any MCP client that supports Streamable HTTP transport and OAuth 2.0 with PKCE can connect.
Setting
Value
Endpoint URL
https://<your-contrast-host>/mcp (for example https://app.contrastsecurity.com/mcp)
Transport
Streamable HTTP (stateless)
HTTP method
POST
Authentication
OAuth 2.0 with PKCE (S256)
OAuth scopes
openid, profile, offline_access
Your client discovers the OAuth configuration automatically through the WWW-Authenticate response header, which points to the standard /.well-known/oauth-protected-resource metadata document. Clients that support Dynamic Client Registration can register at /oauth2/connect/register on the Contrast origin.
These OAuth scopes cover identity only, and that is deliberate. The token grants no data permissions of its own. Authorization is decided by the Contrast platform on every request, using the signed-in user's existing role-based access control. This means there is no broadly-scoped token for an agent to hold or leak, and no authorization scope to get wrong at connection time. See Security and privacy for the full model.
Supported clients
Client
Status
Claude Code CLI
Working
Codex CLI
Working
GitHub Copilot CLI
Working
opencode
Working
Claude Desktop
Working
Gemini CLI
Not yet supported, OAuth compatibility issue
VS Code Copilot plugin
Not yet supported, OAuth compatibility issue
Support for more clients is in progress as their OAuth handling matures. If your client fails during OAuth registration before the login page appears, that is usually a client compatibility issue rather than a problem with your account.
Security and privacy
The hosted server changes how access works without changing what you are allowed to see.
OAuth, not API keys. You sign in through your browser, so there are no long-lived keys to distribute or store on developer machines.
Read-only. Every hosted tool is read-only. You cannot modify, update, or delete data through the hosted server.
Organization-scoped. Each session is bound to the single organization you select at sign-in, so there is no organization ID to guess or get wrong.
Your existing permissions apply. Every request carries your identity to Contrast, which enforces the same role-based access control as the web interface. If you cannot see something in Contrast, your agent cannot see it either. Authorization is a runtime decision made on each request, not a one-time grant encoded in the token, so scoping an agent is the same exercise as scoping its user.
Every tool call is audited. Contrast records each request with a unique identifier, the tool invoked, the user, the organization, and the outcome, supporting incident reconstruction.
No data storage. The hosted server stores none of your data, and your token never appears in a tool response.
The shared warning above still applies. Tool results become part of your AI conversation, so follow your organization's policy on what security data can be sent to your chosen AI client and model.
Available tools
Both servers share the same core tools, so the table below covers them together. The Hosted and Local columns show which server provides each tool. Your agent calls the tools automatically based on your questions.
Authentication
Tool
Description
Hosted
Local
get_user_info
Show who you are signed in as and which organization is active
✅
—
Vulnerabilities (Assess)
Tool
Description
Hosted
Local
search_vulnerabilities
Search vulnerabilities across all applications (org-level)
✅
✅
search_app_vulnerabilities
Search vulnerabilities within a specific application with session filtering
✅
✅
get_vulnerability
Get detailed vulnerability info including stack trace and remediation guidance
✅
✅
list_vulnerability_types
List all available vulnerability types for filtering
✅
✅
Applications
Tool
Description
Hosted
Local
search_applications
Search applications by name, tag, or metadata filters
✅
✅
get_session_metadata
Get session metadata fields available for an application
✅
✅
Servers
Tool
Description
Hosted
Local
search_servers
Search the server inventory for agent health and Protect coverage
✅
✅
Libraries (SCA)
Tool
Description
Hosted
Local
list_application_libraries
List libraries used by an application with class usage statistics and vulnerability counts
✅
✅
list_applications_by_cve
Find applications affected by a specific CVE
✅
✅
Protection (ADR/Protect)
Tool
Description
Hosted
Local
search_attacks
Search attack events with filtering by status, type, and rules
✅
✅
get_protect_rules
Get protection rules configured for an application
✅
✅
Coverage
Tool
Description
Hosted
Local
get_route_coverage
Get route coverage data showing exercised vs discovered routes
✅
✅
SAST (Scan)
Tool
Description
Hosted
Local
get_scan_project
Get SAST project details and vulnerability counts
✅
✅
get_scan_results
Get SAST scan results in SARIF format
—
✅
CVEs, Issues, Incidents, and Observations
These tools are available only on the hosted server and require the Contrast unified data platform (NorthStar) to be enabled for your organization.
Tool
Description
Hosted
Local
search_cves
Search CVEs across your organization for CVE Shield exposure and risk
✅
—
list_cve_issues
List affected applications and libraries for a CVE, one issue per pair
✅
—
get_cve_impact
Get CVE risk, exposure, and shield protection posture across your organization
✅
—
search_issues
Search and filter security issues across your organization
✅
—
get_issue
Get full details for a specific issue
✅
—
list_issue_incidents
List incidents linked to an issue
✅
—
list_issues_by_library
List open issues associated with an application library
✅
—
search_incidents
Search and filter incidents
✅
—
get_incident
Get full details for a specific incident
✅
—
list_incident_issues
List issues linked to an incident
✅
—
get_observation
Get full details for a specific observation
✅
—
list_issue_observations
List observations linked to an issue (cursor-paginated)
✅
—
list_incident_observations
List observations linked to an incident (cursor-paginated)
✅
—
Local MCP Server
The Local MCP Server is the open-source server in this repository. Your MCP client launches it as a local process over stdio, it authenticates with Contrast API and service keys, and it connects to your own Contrast instance, including on-premises and EOP. Use it when you cannot use the hosted server, or when you need raw SARIF scan output.
The local server provides the tools marked Local in Available tools above.
Quick start
Prerequisites
Docker (recommended) or Java 21+ for JAR deployment
Getting the JAR file (download, attestation verification, and build from source), proxy configuration, and troubleshooting have moved to the Local MCP Server guide.
Sample prompts
These prompts work with either server, except where a section says otherwise.
For the Developer
Remediate Vulnerabilities in Code
Please list vulnerabilities for Application Y.
Give me details about vulnerability X in Application Y.
Review vulnerability X and fix it.
Third-Party Library Remediation
Which libraries in Application X have high or critical vulnerabilities and are actively used?
Update library X, which has a critical vulnerability, to the safe version.
Which libraries in Application X are not being used?
Retrieve Applications by Tag
Please give me the applications tagged with "backend."
Retrieve Applications by Metadata
Please give me the applications with metadata "dev-team" and "backend-team."
Retrieve Vulnerabilities by Session Metadata
Give me the session metadata for Application X.
Give me the vulnerabilities in the latest session for Application X.
Give me the vulnerabilities for session metadata "Branch Name" "feature/some-new-fix" for Application X.
Give me the route coverage for the latest session for Application X.
Give me the route coverage for session metadata "Branch Name" "feature/some-new-fix" for Application X.
For the Security Professional
Please give me a breakdown of applications and servers vulnerable to CVE-xxxx-xxxx.
Please list the libraries for the application named xxx and tell me what version of commons-collections is being used.
Which vulnerabilities in Application X are being blocked by a Protect or ADR rule?
Which production servers do not have Protect enabled?
Show me servers whose agents are out of date.
Show me attack events from the last 7 days and tell me which were exploited.
Hosted server with the unified data platform (NorthStar)
These prompts require the hosted server and the Contrast unified data platform (NorthStar) to be enabled for your organization.
Which CVEs pose the highest risk across my organization?
Is my organization shielded from CVE-xxxx-xxxx?
Which applications and libraries are affected by CVE-xxxx-xxxx?
Show me open security issues for Application X.
Give me the details of incident X and the issues linked to it.
What observations provide evidence for issue X?
Data privacy
The Contrast MCP Server provides a bridge between your Contrast Data and the AI Agent/LLM of your choice.
By using Contrast's MCP server you will be providing your Contrast Data to your AI Agent/LLM, it is your responsibility to ensure that the AI Agent/LLM you use complies with your data privacy policy.
Depending on what questions you ask the following information will be provided to your AI Agent/LLM.
Application Details
Application Rule configuration
Vulnerability Details
Route Coverage data
ADR/Protect Attack Event Details
Server inventory and agent details (hostnames, paths, agent versions, environments, log levels, and tags)
Issue, incident, observation, and CVE Shield data (hosted server with NorthStar)
Changelog
See CHANGELOG.md for the complete release history, including breaking changes and new features.