# UNPKG

> UNPKG is a free MCP server for security. Live npm and UNPKG lookups, import map checks and malware or CVE verdicts for agents. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://mcp.unpkg.com
- **Repository:** https://github.com/unpkg/unpkg-mcp
- **MCP Registry name:** io.github.unpkg/unpkg-mcp
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-14

## About

Models often invent package versions, file paths that were never published, or Node-only entry points. This server answers from live data instead: it resolves an exact version, tag or range, lists real files, builds canonical file URLs and checks that a URL resolves.

Its audit tool classifies each runtime dependency in a package.json as convert now, convert carefully, keep bundled, needs review or not found, produces an import map, and recognises framework-managed packages. Import maps can be generated and validated as a whole, and bandwidth offload is estimated as a range with stated assumptions rather than an invented figure.

Package safety checks return a malware verdict with review state and the CVEs affecting the exact version, plus the first patched version. These work anonymously, 25 packages per call. Signing in through OAuth at shield.unpkg.com, for approved Shield beta accounts, adds four tools over your own domains, watchlist and pin or block rules. Connect at https://mcp.unpkg.com/mcp.

## Features

- **Version resolution:** Maps exact, tag or range specs to real versions and browser entry points.
- **Dependency audit:** Sorts dependencies into convert, keep or review groups.
- **Import map tools:** Generate and validate import maps, checking file existence.
- **Safety verdicts:** Malware and CVE results for exact package versions.
- **Browser-ready search:** Search results annotated for browser readiness.
- **Shield login:** Optional OAuth adds your own domain and policy data.

## Good for

- Convert a page to load imports from UNPKG and verify it runs
- Check a package version for malware before use
- Find a small date-picker that works as a browser import
- Estimate bandwidth saved by moving packages to a CDN

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http unpkg-mcp https://mcp.unpkg.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.unpkg.com/mcp
```

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

```json
{
  "mcpServers": {
    "unpkg-mcp": {
      "url": "https://mcp.unpkg.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "unpkg-mcp": {
      "type": "http",
      "url": "https://mcp.unpkg.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "unpkg-mcp": {
      "serverUrl": "https://mcp.unpkg.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "unpkg-mcp": {
      "type": "http",
      "url": "https://mcp.unpkg.com/mcp"
    }
  }
}
```

## Tools

- `resolve_package`: Resolves a version, tag or range to a real version and browser entry points.
- `search_packages`: Searches npm with browser-readiness annotations.
- `list_files`: Lists the real files in a package version.
- `build_file_url`: Builds a canonical file URL under a version policy.
- `audit_dependencies`: Classifies a package.json dependency map and suggests URLs and an import map.
- `verify_url`: Checks that a UNPKG URL resolves.
- `generate_importmap`: Generates an import map from bare specifiers.
- `check_importmap`: Validates an import map as a whole.
- `estimate_migration_impact`: Estimates bandwidth offload as a range.
- `shield_check_packages`: Returns malware verdicts and CVEs for exact package versions.
- `shield_whoami`: Shows the connected account, organisation and entitlements.
- `shield_domain_packages`: Lists packages seen on your verified domains with verdicts.
- `shield_simulate_request`: Previews Shield's pin or block decision.
- `shield_watchlist_status`: Shows monitored packages, blocklist and pin policies.

## FAQ

### Do I need an account?

No. The general tools and anonymous package checks need no login.

### What does Shield login add?

Tools scoped to your organisation: domains, simulated pin or block decisions and the watchlist.

### How many packages per safety check?

25 per call anonymously, up to 200 with Shield login.

### What is the endpoint?

https://mcp.unpkg.com/mcp over streamable HTTP.

### Is UNPKG free?

Yes. UNPKG is free to use.

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

Run this command in your terminal: claude mcp add --transport http unpkg-mcp https://mcp.unpkg.com/mcp

### What are the best alternatives to UNPKG?

The closest alternatives to UNPKG 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/unpkg
