pinright — Claude Code MCP server for dependency checks
The pinright Claude Code MCP server supplies docs for the exact library version in use and checks dependencies before installation. Its hook can stop an install command when a package version has known advisories.
MIT ★ 5 updated 2026-11-13
claude mcp add --env GITHUB_TOKEN=<GITHUB_TOKEN> --env PINRIGHT_GH_CLI=<PINRIGHT_GH_CLI> --transport stdio pinright -- npx -y pinrightWhat pinright does
pinright gives the agent documentation matched to a library version and checks a package before its install command runs. Its MCP tools report known advisories and suggest a version to pin; the pre-install hook can block the command.
Checks also cover malware, misleading package names, and versions that do not exist. For a full dependency-tree audit, pinright includes check-manifest, SARIF, and a GitHub Action.
Node 20.9 or newer is required. The install hook is available in six clients, including Claude Code. The init command connects the MCP server and writes a starter .pinright.json file.
What it helps with
- check a package for known advisories before installing it
- find a safer dependency version to pin
- retrieve documentation for a specific library version
- audit the dependency tree from a lockfile
Example prompts for the agent
- Check
[email protected]for advisories and suggest a safer version. - Show the docs for the version of this library in the project.
- Audit the project manifest for vulnerable dependencies.
How to install pinright
Platform CLI
claude mcp add --env GITHUB_TOKEN=<GITHUB_TOKEN> --env PINRIGHT_GH_CLI=<PINRIGHT_GH_CLI> --transport stdio pinright -- npx -y pinrightReplace <…> with your own values
Platform CLI
codex mcp add pinright --env GITHUB_TOKEN=<GITHUB_TOKEN> --env PINRIGHT_GH_CLI=<PINRIGHT_GH_CLI> -- npx -y pinrightReplace <…> with your own values
Config file
{
"mcpServers": {
"pinright": {
"command": "npx",
"args": [
"-y",
"pinright"
],
"env": {
"GITHUB_TOKEN": "<GITHUB_TOKEN>",
"PINRIGHT_GH_CLI": "<PINRIGHT_GH_CLI>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"pinright": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"pinright"
],
"env": {
"GITHUB_TOKEN": "<GITHUB_TOKEN>",
"PINRIGHT_GH_CLI": "<PINRIGHT_GH_CLI>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e GITHUB_TOKEN=<GITHUB_TOKEN> -e PINRIGHT_GH_CLI=<PINRIGHT_GH_CLI> pinright npx -y pinrightReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about pinright
How do I install pinright in Claude Code?
Add the MCP server with claude mcp add pinright -e GITHUB_TOKEN=<GITHUB_TOKEN> -- npx -y pinright.
What does pinright do?
It provides documentation for the exact library version and checks dependencies before installation. Its hook can block an install command for a version with known advisories.
What does pinright need to run?
Node 20.9 or newer is required. The install command also sets GITHUB_TOKEN.