docs: add snyk remote mcp - #1473
Open
RaduPetreTarean wants to merge 4 commits into
Open
Conversation
✅ Snyk checks have passed. No issues have been found so far.
💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse. |
mihaisau-snyk
requested changes
Jul 17, 2026
mihaisau-snyk
left a comment
Collaborator
There was a problem hiding this comment.
Style guide fixes: "log in" not "sign in," avoid the modal "may," and "visit" not "see" when linking to a page (3 instances). Suggestions inline.
mihaisau-snyk
self-requested a review
July 20, 2026 09:12
mihaisau-snyk
requested changes
Jul 20, 2026
| | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ||
| | `snyk_list_issues` | Lists one cursor-paginated page of Organization issues. Supports optional Project, status, severity, type, and ignored-state filters. | | ||
| | `snyk_get_issue` | Returns full details for one issue instance, including source location, coordinates, and remediation data. | | ||
| | `snyk_get_issue_counts` | Aggregates all matching Organization issue instances by severity, type, status, and Project. A positive `limit` bounds analysis; `project_limit` controls the size of the Project breakdown. | |
Collaborator
There was a problem hiding this comment.
Suggested change
| | `snyk_get_issue_counts` | Aggregates all matching Organization issue instances by severity, type, status, and Project. A positive `limit` bounds analysis; `project_limit` controls the size of the Project breakdown. | | |
| | `snyk_get_issue_counts` | Aggregates all matching Organization issue instances by severity, type, status, and Project. A positive `limit` bounds analysis. `project_limit` controls the size of the Project breakdown. | |
|
|
||
| The `top` argument controls how much prioritized evidence is returned. The default is 100 for Project risk and remediation backlog reports and 20 for security posture and Group risk rollup reports. Set `top: 0` to return all analyzed evidence. | ||
|
|
||
| For `snyk_get_issue_counts`, `limit` defaults to 0 and analyzes all matching pages. A positive value bounds the analysis; when that bound is reached, `truncated` is true and a warning identifies the counts as incomplete. |
Collaborator
There was a problem hiding this comment.
Suggested change
| For `snyk_get_issue_counts`, `limit` defaults to 0 and analyzes all matching pages. A positive value bounds the analysis; when that bound is reached, `truncated` is true and a warning identifies the counts as incomplete. | |
| For `snyk_get_issue_counts`, `limit` defaults to 0 and analyzes all matching pages. A positive value bounds the analysis. When that bound is reached, `truncated` is true and a warning identifies the counts as incomplete. |
|
|
||
| For `snyk_get_issue_counts`, `limit` defaults to 0 and analyzes all matching pages. A positive value bounds the analysis; when that bound is reached, `truncated` is true and a warning identifies the counts as incomplete. | ||
|
|
||
| The `project_limit` argument defaults to 10 for issue counts, security posture reports, and remediation backlog reports. It controls only the size of the `by_project` breakdown; set it to 0 to return every matching Project entry. Responses include `by_project_total` and `by_project_truncated` so clients can identify a bounded breakdown. For remediation backlogs, `action_group_limit` defaults to 20 and controls the number of returned remediation action groups; set it to 0 to return all action groups. |
Collaborator
There was a problem hiding this comment.
Suggested change
| The `project_limit` argument defaults to 10 for issue counts, security posture reports, and remediation backlog reports. It controls only the size of the `by_project` breakdown; set it to 0 to return every matching Project entry. Responses include `by_project_total` and `by_project_truncated` so clients can identify a bounded breakdown. For remediation backlogs, `action_group_limit` defaults to 20 and controls the number of returned remediation action groups; set it to 0 to return all action groups. | |
| The `project_limit` argument defaults to 10 for issue counts, security posture reports, and remediation backlog reports. It controls only the size of the `by_project` breakdown. Set it to 0 to return every matching Project entry. Responses include `by_project_total` and `by_project_truncated` so clients can identify a bounded breakdown. For remediation backlogs, `action_group_limit` defaults to 20 and controls the number of returned remediation action groups. Set it to 0 to return all action groups. |
|
|
||
| ### Remediation handoff and verification | ||
|
|
||
| The `snyk_get_remediation_handoff` tool requires an Organization name, slug, or UUID and an issue UUID. It returns the primary issue identity and a fallback identity based on the Project, rule, source or manifest path, and affected package. Repository, branch, and source details are included only when Snyk Project, target, or issue data contains them. If the Project has a `prodsec-commit-hash` tag, the value is returned as `handoff.project.commit_hash`; otherwise, `commit_reference` is identified as missing in `handoff.context`. |
Collaborator
There was a problem hiding this comment.
Suggested change
| The `snyk_get_remediation_handoff` tool requires an Organization name, slug, or UUID and an issue UUID. It returns the primary issue identity and a fallback identity based on the Project, rule, source or manifest path, and affected package. Repository, branch, and source details are included only when Snyk Project, target, or issue data contains them. If the Project has a `prodsec-commit-hash` tag, the value is returned as `handoff.project.commit_hash`; otherwise, `commit_reference` is identified as missing in `handoff.context`. | |
| The `snyk_get_remediation_handoff` tool requires an Organization name, slug, or UUID and an issue UUID. It returns the primary issue identity and a fallback identity based on the Project, rule, source or manifest path, and affected package. Repository, branch, and source details are included only when Snyk Project, target, or issue data contains them. If the Project has a `prodsec-commit-hash` tag, the value is returned as `handoff.project.commit_hash`. Otherwise, `commit_reference` is identified as missing in `handoff.context`. |
|
|
||
| If batch package testing is unavailable, `snyk_test_packages` returns `snyk_test_package` as the fallback tool. Empty SBOM and dependency results include data-quality warnings. | ||
|
|
||
| The `snyk_review_project_sbom` tool accepts an Organization and Project by name or UUID. Use `project_type`, `project_origin`, and `target_file` to disambiguate duplicate Project names. The `format` argument supports CycloneDX 1.4, 1.5, or 1.6 JSON and SPDX 2.3 JSON; the default is `cyclonedx1.4+json`. Its evidence controls are: |
Collaborator
There was a problem hiding this comment.
Suggested change
| The `snyk_review_project_sbom` tool accepts an Organization and Project by name or UUID. Use `project_type`, `project_origin`, and `target_file` to disambiguate duplicate Project names. The `format` argument supports CycloneDX 1.4, 1.5, or 1.6 JSON and SPDX 2.3 JSON; the default is `cyclonedx1.4+json`. Its evidence controls are: | |
| The `snyk_review_project_sbom` tool accepts an Organization and Project by name or UUID. Use `project_type`, `project_origin`, and `target_file` to disambiguate duplicate Project names. The `format` argument supports CycloneDX 1.4, 1.5, or 1.6 JSON and SPDX 2.3 JSON. The default is `cyclonedx1.4+json`. Its evidence controls are: |
|
|
||
| ## Understand investigation boundaries | ||
|
|
||
| Snyk Remote MCP provides audit logs, cloud issue filters, container inventory, and risk reports as separate evidence. It does not expose a unified attack-path or runtime graph and does not infer deployment causality or blast radius. If an MCP client correlates external SIEM or ticketing data, conclusions must preserve source attribution and distinguish external evidence from Snyk observations. |
Collaborator
There was a problem hiding this comment.
Suggested change
| Snyk Remote MCP provides audit logs, cloud issue filters, container inventory, and risk reports as separate evidence. It does not expose a unified attack-path or runtime graph and does not infer deployment causality or blast radius. If an MCP client correlates external SIEM or ticketing data, conclusions must preserve source attribution and distinguish external evidence from Snyk observations. | |
| Snyk Remote MCP provides audit logs, cloud issue filters, container inventory, and risk reports as separate evidence. It does not expose a unified attack-path or runtime graph and does not infer deployment causality or blast radius. If an MCP client correlates external SIEM (security information and event management) or ticketing data, conclusions must preserve source attribution and distinguish external evidence from Snyk observations. |
Co-authored-by: mihaisau-snyk <mihai.sau@snyk.io>
RaduPetreTarean
force-pushed
the
docs/add-snyk-remote-mcp
branch
from
August 7, 2026 13:41
a53fa79 to
b14ca80
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds the Snyk Remote MCP into the user docs
Note
Low Risk
Changes are documentation-only and do not alter product code, authentication, or data handling.
Overview
Adds Snyk Remote MCP to the developer-tools docs: a new integration section with a main guide and a tools reference, linked from the integrations table of contents.
The integrations overview no longer states that Snyk lacks a hosted MCP server. It now contrasts Snyk Studio’s local MCP (CLI, local scans) with Snyk Remote MCP (hosted, read-only queries over existing Snyk data). The glossary adds a Snyk Remote MCP definition and fixes dependency bullet formatting.
Reviewed by Cursor Bugbot for commit b14ca80. Bugbot is set up for automated code reviews on this repo. Configure here.