Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint · rollforge · bestiary · statline · matchpoint · retail · agentops · browserworkflow · modelrouter · compose
$ man npm-package-stats

/npm-package-stats

agentutility / web-probe / npm-package-stats
PRICE / CALL
$0.003
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
webprobe
CATEGORY
uncategorized
STATUS
live
NAME
npm-package-stats fetches the public npm registry record for a package and returns description, license, repository, latest version, total version count, r…
SYNOPSIS
POST https://x402.agentutility.ai/npm-package-stats
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }
↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.
DESCRIPTION

Fetches the public npm registry record for a package and returns description, license, repository, latest version, total version count, recent versions with publish timestamps and deprecation flags, age in days, days since last release, maintainer count + list, and downloads for the last day, week, month, year. The npm registry numbers behind package-risk-npm, just the metrics without the risk write-up. Public npm registry (registry.npmjs.org + api.npmjs.org), commercial use permitted under the npm Public Registry Open Source Terms. Use it for npm package stats, npm registry lookup, npm downloads, package release history, or package metadata.

INPUTrequest schema
propertytypedescriptionreq?
packagestringnpm package name. Supports scoped names ('@types/node', '@vercel/next').required
recent_versionsnumberHow many most-recent version entries to include. 1-20. Default 5.optional
OUTPUTresponse shape
fieldtypedescription
packagestringEcho of the requested package name.
namestringCanonical package name as recorded in the npm registry document.
descriptionstringPackage description string from the registry document. null if unset.
licensestringLicense identifier (e.g. 'MIT') extracted from the registry document. null if unset.
homepagestringHomepage URL from the registry document. null if unset.
repositorystringRepository URL from the registry document. null if unset.
keywordsarrayPackage keywords array from the registry document.
latest_versionstringCurrent 'latest' dist-tag from the registry.
total_versionsnumberTotal number of versions ever published with timestamps in the registry.
recent_versionsarrayMost-recent N versions, each with version string, published ISO timestamp, and deprecated boolean.
first_publishedstringISO timestamp of the earliest version publish. Useful for age math.
last_publishedstringISO timestamp of the most recent version publish.
age_daysnumberDays since the first publish.
days_since_last_releasenumberDays since the most recent publish — staleness signal.
maintainer_countnumberCount of registered maintainers on the package.
maintainersarrayFirst 10 maintainer usernames.
downloadsobjectObject with last_day, last_week, last_month, last_year integer download counts from api.npmjs.org. Individual fields may be null if the registry returned an error for that window.
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/npm-package-stats \
  -H 'Content-Type: application/json' \
  -d '{ }'
first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.
EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the npm-package-stats tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
web-probenpmpackage-statsdownloadsregistrydependency
methods
POST
cluster
webprobe
price
$0.003 USDC per call
ADJACENTother endpoints in webprobe
endpointdescriptionprice
crates-io-statsFetches the public crates.io API record for a Rust crate and returns description, license, repository, homepage, documentation, keywords,…$0.003
crypto-news-apiReturns recent cryptocurrency headline metadata and sentiment.$0.003
homoglyph-checkDetects Unicode lookalike characters that impersonate ASCII Latin letters, a common phishing-domain trick.$0.003
jwt-decodeDecodes a JWT and inspects its claims without needing the signing key.$0.003
pypi-package-statsFetches the public PyPI JSON record for a Python package and returns summary, license, homepage, repository, documentation, issues URL, a…$0.003
url-metadata-extractExtracts page metadata from any URL: title, description, Open Graph and Twitter Card tags, canonical link, and favicon.$0.003
keyword-suggestKeyword and autocomplete suggestions for any seed query.$0.002
arxiv-bibtexTurns an arXiv paper into a BibTeX entry: pulls title, authors, year, abstract, and DOI from the arXiv API and generates a properly-forma…$0.005
SEE ALSO
agentutility · webprobe · x402 · mcp · llms.txt · registry.json · bazaar.x402.org