Documentation
Tools exposed by Dependency Risk Audit and the limits that apply.
Connect
Server URL: https://deps.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.
Tools
audit_dependencies
Parses a lockfile or manifest and reports known vulnerabilities and licences for its pinned packages.
- Inputs: manifest_url or manifest_text, filename and format (optional), offset (optional), continuation (optional)
- Limits: Counts one audit per call, except a continuation call that fills in details of an earlier call. At most 500 packages per call; file size up to 3 MB.
get_vulnerability
The full OSV record of one vulnerability: aliases, summary, severity, CVSS, affected ranges, fixed versions and references.
- Inputs: id (for example GHSA-... or CVE-...)
- Limits: No quota.
check_package
Vulnerabilities, declared licence and latest version of one package at one version.
- Inputs: ecosystem, name, version
- Limits: Counts one audit.
save_project
Saves a project (name plus its package list) and records its current vulnerabilities as the baseline for scheduled re-scans.
- Inputs: name, manifest_url or manifest_text, filename and format (optional)
- Limits: Counts one audit. Saved-project limit by plan; at most 1,000 packages per project.
list_projects
Lists saved projects with package counts, last scan time and next scheduled scan.
- Inputs: none
- Limits: No quota.
remove_project
Removes a saved project.
- Inputs: name
- Limits: No quota.
rescan_now
Re-scans one saved project immediately and reports and records any new vulnerabilities.
- Inputs: name
- Limits: Counts one audit.
get_alerts
Recorded alerts for new vulnerabilities, unseen first; marks the returned alerts as seen.
- Inputs: limit (optional), include_seen (optional)
- Limits: No quota.
account_status
Shows the account email, plan, usage and limits.
- Inputs: none
- Limits: none
activate_license
Binds a licence key to the account.
- Inputs: license_key (string)
- Limits: Key must belong to this product.
Plan limits
| Limit | Free | Pro |
|---|---|---|
| audits | 30 | 1000 |
| saved projects | 3 | 100 |
Network behaviour
Outbound requests use the user agent TidyButtonBot/1.0 (+https://deps.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.