pkgproof
Check an npm or PyPI package for advisories and typosquats before you install it
- Pricing
- Freemium
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 0.2.1
- Listing updated
- 2 days ago
About pkgproof
pkgproof is a freemium MCP server for security. It runs locally on your machine and is started by your AI client.
pkgproof answers with one word, safe, caution, block or does_not_exist, after nine checks: whether the package exists, known advisories, install scripts, typosquat and combosquat names, scope confusion, a declared source repository, reputation and release age. Each reason is labelled as fact or heuristic with its source.
Its design choice is to give no verdict rather than a weak one. If the package registry or OSV cannot be reached, the service returns a 502 error instead of quietly skipping a check, so a safe result means every check ran and passed.
The MCP server has a single tool, verify_package. The first verification each day needs no key or account; later checks cost $0.05 in USDC over x402, using a throwaway wallet on Algorand or Base. Releases carry an npm provenance attestation, and Claude Desktop users can install a prebuilt .mcpb bundle.
Install
Run in a terminal
claude mcp add pkgproof --env PKGPROOF_ALGORAND_PRIVATE_KEY='<PKGPROOF_ALGORAND_PRIVATE_KEY>' --env PKGPROOF_BASE_PRIVATE_KEY='<PKGPROOF_BASE_PRIVATE_KEY>' -- npx -y @pkgproof/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"pkgproof": {
"command": "npx",
"args": [
"-y",
"@pkgproof/mcp"
],
"env": {
"PKGPROOF_ALGORAND_PRIVATE_KEY": "<PKGPROOF_ALGORAND_PRIVATE_KEY>",
"PKGPROOF_BASE_PRIVATE_KEY": "<PKGPROOF_BASE_PRIVATE_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"pkgproof": {
"command": "npx",
"args": [
"-y",
"@pkgproof/mcp"
],
"env": {
"PKGPROOF_ALGORAND_PRIVATE_KEY": "<PKGPROOF_ALGORAND_PRIVATE_KEY>",
"PKGPROOF_BASE_PRIVATE_KEY": "<PKGPROOF_BASE_PRIVATE_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"pkgproof": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@pkgproof/mcp"
],
"env": {
"PKGPROOF_ALGORAND_PRIVATE_KEY": "<PKGPROOF_ALGORAND_PRIVATE_KEY>",
"PKGPROOF_BASE_PRIVATE_KEY": "<PKGPROOF_BASE_PRIVATE_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"pkgproof": {
"command": "npx",
"args": [
"-y",
"@pkgproof/mcp"
],
"env": {
"PKGPROOF_ALGORAND_PRIVATE_KEY": "<PKGPROOF_ALGORAND_PRIVATE_KEY>",
"PKGPROOF_BASE_PRIVATE_KEY": "<PKGPROOF_BASE_PRIVATE_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"pkgproof": {
"command": "npx",
"args": [
"-y",
"@pkgproof/mcp"
],
"env": {
"PKGPROOF_ALGORAND_PRIVATE_KEY": "<PKGPROOF_ALGORAND_PRIVATE_KEY>",
"PKGPROOF_BASE_PRIVATE_KEY": "<PKGPROOF_BASE_PRIVATE_KEY>"
}
}
}
}Configuration
PKGPROOF_ALGORAND_PRIVATE_KEYBase64 account key of a throwaway Algorand wallet holding USDC (ASA 31566704) on Algorand Mainnet. Not a 25-word mnemonic. Optional: the first verification each day is free without any key. This is the rail payments prefer.PKGPROOF_BASE_PRIVATE_KEY0x-prefixed private key of a throwaway EVM wallet holding USDC on Base. Optional, and only used when no Algorand key is configured. Needs no ETH: payment is an off-chain signature and the facilitator pays the gas.
Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- verify_package
- Runs nine checks on an npm or PyPI package and returns a verdict.
What it does
- Nine checks
- Existence, advisories, install scripts, typosquats, scope, repository, reputation and age.
- Four verdicts
- Returns safe, caution, block or does_not_exist.
- Labelled reasons
- Each finding is marked fact or heuristic with its source.
- No silent gaps
- Unreachable data sources produce an error, not a verdict.
- Pay per check
- $0.05 in USDC via x402 after the free daily check.
- Signed releases
- npm provenance attestation for the server package.
Good for
- Vet a dependency an agent wants to add
- Screen a suspicious name for typosquatting
- Check install scripts before running npm install
- Gate pip install in a CI step
Pricing
Freemium
One free check a day; $0.05 per check after, paid in USDC
Prices change. Check pkgproof.net before you buy.
pkgproof FAQ
Is it free?
The first verification each day is free with no key; later ones cost $0.05 in USDC.
Which ecosystems are supported?
npm and PyPI.
What happens if a data source is down?
The request fails with a 502 instead of returning a partial verdict.
Do I need an account?
No. Payment is the authorisation.
Is pkgproof free?
pkgproof has a free plan, with paid plans for more usage or features.
How do I add pkgproof to Claude Code?
Run this command in your terminal: claude mcp add pkgproof --env PKGPROOF_ALGORAND_PRIVATE_KEY='<PKGPROOF_ALGORAND_PRIVATE_KEY>' --env PKGPROOF_BASE_PRIVATE_KEY='<PKGPROOF_BASE_PRIVATE_KEY>' -- npx -y @pkgproof/mcp
What are the best alternatives to pkgproof?
The closest alternatives to pkgproof are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to pkgproof

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools