# pinright

> pinright is an open-source MCP server for developer tools. MCP server and CLI giving coding agents version-matched docs and a dependency check. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows, vscode
- **Website:** https://pinright.dev
- **Repository:** https://github.com/hiper-ai/pinright
- **MCP Registry name:** io.github.Hiper-AI/pinright
- **Categories:** developer tools, security
- **Listing updated:** 2026-11-14

## About

pinright targets a specific failure: coding agents write dependency versions from memory, and docs-only MCP servers do not check what gets pinned. It serves documentation for the exact version being installed and returns a verdict on every package an agent adds, covering known advisories, malware records, lookalike names and packages that do not exist, and it suggests a fix on the same release line.

Beyond the MCP server, it ships a pre-install hook that blocks a risky install command before it runs, a CLI and a GitHub Action with SARIF output. The site says setup covers 16 clients, six of them with the hook: Claude Code, Cursor, VS Code with Copilot, OpenAI Codex, Gemini CLI and Windsurf. It needs Node 20.9 or newer, with no account, key or telemetry.

The project's own benchmark reports 0% of direct pins with an advisory versus 40% to 42% with no docs tool; the methods page documents caveats. An optional GITHUB_TOKEN raises the GitHub API limit from 60 to 5,000 requests an hour.

## Features

- **Version-matched docs:** get-docs serves documentation for the version the agent will install.
- **Dependency verdicts:** check-package reports advisories, malware, lookalike names and nonexistent versions.
- **Pre-install hook:** Blocks a risky install and names a fix on the same release line.
- **Manifest audit:** check-manifest and a GitHub Action audit a whole lockfile with SARIF output.
- **Local and private:** Runs locally with no account, key or telemetry.

## Good for

- Stop an agent pinning a vulnerable library version
- Give an agent docs for the exact version in a project
- Audit a lockfile in CI
- Catch typo-squatted package names before install

## Install

### Claude Code (Terminal)

```sh
claude mcp add pinright --env GITHUB_TOKEN='<GITHUB_TOKEN>' -- npx -y pinright
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pinright": {
      "command": "npx",
      "args": [
        "-y",
        "pinright"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pinright": {
      "command": "npx",
      "args": [
        "-y",
        "pinright"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pinright": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "pinright"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "pinright": {
      "command": "npx",
      "args": [
        "-y",
        "pinright"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "pinright": {
      "command": "npx",
      "args": [
        "-y",
        "pinright"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

## Tools

- `check-package`: Verdict on a dependency with the full advisory list and the version to pin.
- `get-docs`: Documentation for a specific library version.

## FAQ

### Does it need an account or API key?

No. The site says no account, key or telemetry; a GitHub token is optional.

### Which clients get the hook?

Six: Claude Code, Cursor, VS Code with GitHub Copilot, OpenAI Codex, Gemini CLI and Windsurf.

### What licence is it under?

MIT, open source.

### What are the requirements?

Node 20.9 or newer.

### Is pinright free?

Yes. pinright is open source, so you can use and self-host it for free.

### How do I add pinright to Claude Code?

Run this command in your terminal: claude mcp add pinright --env GITHUB_TOKEN='<GITHUB_TOKEN>' -- npx -y pinright

### What are the best alternatives to pinright?

The closest alternatives to pinright are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/pinright
