Skip to main content

At a glance

Credentials

Set these per environment. See Connect an integration.
VariableRequiredDescription
SNYK_TOKENYesSnyk API token (personal token or service account token) Docs.

Setup

  1. Sign up for Snyk: Create a free account at https://app.snyk.io and import at least one repository so projects and issues exist to query.
  2. Get your API token: Go to Account Settings (https://app.snyk.io/account) and copy your personal API token, or create a service account token for shared use. Free plans include API access via the personal token.
  3. Set the environment variable: Add the token to your .env as SNYK_TOKEN=…
  4. Verify access: Run List Organizations, then List Projects with one of the returned org IDs.
  • Authentication uses ‘Authorization: token <SNYK_TOKEN>’ - the prefix is ‘token’, not ‘Bearer’
  • Every REST API request requires a date-based ?version= query parameter; tools default to 2024-10-15
  • If your account is in a regional environment (e.g. US-02 at api.us.snyk.io), API hosts differ - these tools target the default https://api.snyk.io
  • Responses follow the JSON:API format: items are under data[] with attributes, pagination under links
Provider API reference: https://docs.snyk.io/snyk-api

Tools

ToolAccessDescription
List OrganizationsReadList Snyk organizations the token can access
List ProjectsReadList projects in a Snyk organization
Get ProjectReadGet a project’s details in a Snyk organization
List IssuesReadList security issues in a Snyk organization, optionally filtered by severity or status
Get OrganizationReadGet details of a Snyk organization

Example prompts

  • List the open critical and high severity issues across my Snyk organization and summarize them by project.
  • List my Snyk projects and show which ones were tested most recently.