npm_downloads
Download counts for an npm package over last-day, last-week, or last-month.
This record as markdown: /tools/io-github-malamutemayhem-unclick-mcp-server/npm-downloads.md
What npm_downloads does on UnClick
AI agents call npm_downloads to retrieve information from UnClick without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Package name, e.g. @unclick/mcp-server. |
period | string | — | last-day, last-week (default), or last-month. |
Parameters from the server's own tool schema.
Why npm_downloads is rated Low
The tool only retrieves historical download statistics from npm, which is a read-only data retrieval operation. It has no ability to modify packages, execute code, or cause any side effects. The blast radius of misuse is minimal—worst case, an agent fetches statistics they shouldn't have access to, with no impact on system integrity or user data.
From the tool's definition Tool description states it retrieves 'Download counts for an npm package' with no mention of modification, deletion, or side effects. This is a pure query operation.
Attacks that exploit this kind of access
The rule that runs npm_downloads safely
PolicyLayer is an MCP gateway: it sits between your AI agents and UnClick, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For npm_downloads, this is the rule to start with:
npm_downloads is read-only, so it stays allowed. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect UnClick, apply this rule, and every npm_downloads call is checked against it from then on.
Questions about npm_downloads
Download counts for an npm package over last-day, last-week, or last-month. It is categorised as a Read tool in the UnClick MCP Server, which means it retrieves data without modifying state.
npm_downloads accepts 2 parameters: name, period. Required: name. The full parameter table on this page comes from the server's own tool schema.
Register the UnClick MCP server in PolicyLayer and add a rule for npm_downloads: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches UnClick. Nothing to install.
npm_downloads is a Read tool with low risk. Read-only tools are generally safe to allow by default.
Yes. Add a rate_limit block to the npm_downloads rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for npm_downloads. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
npm_downloads is provided by the UnClick MCP server (@unclick/mcp-server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on UnClick, and thousands of servers like it.
This server
Across the catalogue