npm MCP server for AI agents
Let Claude, ChatGPT or your own agent read npm: 3 typed functions through one MCP server. No npm API key needed.
- Site
- npmjs.com
- Functions
- 3
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just npm
An MCP server for npm alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/npmjsEvery site
One MCP server for npm and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
Read 3
getDownloadsReturns a package's real download count off npmjs.com's own public download-counts API.Arguments
Name Type Required packageNamestringYes periodstringNo Returns
npmjsDownloadsinterface npmjsDownloads { package: string; downloads: number; start: string; // ISO date end: string; // ISO date }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/npmjs/getDownloadsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npmjs.getDownloads("react", "last-week");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npmjs.getDownloads("react", "last-week"))curl -X POST https://api.bowmark.ai/v1/sites/npmjs/getDownloads \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"packageName":"react","period":"last-week"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.npmjs.getDownloads("react", "last-week");getPackageInfoOne package's metadata straight off the npm registry (registry.npmjs.org/<package>): every published version, its dist-tags, and for the requested…Arguments
Name Type Required packageNamestringYes versionstringNo Returns
npmjsPackageInfointerface npmjsPackageInfo { name: string; description: string | null; distTags: Record<string, string>; // dist-tags, e.g. { latest: "1.3.0" } versions: string[]; // every published version, oldest first created: string | null; modified: string | null; // ISO-8601 version: string; // the version the fields below describe publishedAt: string | null; license: string | null; deprecated: string | null; // the deprecation message, if any dependencies: Record<string, string>; devDependencies: Record<string, string>; peerDependencies: Record<string, string>; dist: { tarball: string; shasum: string | null; integrity: string | null; fileCount: number | null; unpackedSize: number | null }; repository: string | null; homepage: string | null; maintainers: { name: string; email: string | null }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/npmjs/getPackageInfoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npmjs.getPackageInfo("left-pad");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npmjs.getPackageInfo("left-pad"))curl -X POST https://api.bowmark.ai/v1/sites/npmjs/getPackageInfo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"packageName":"left-pad"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.npmjs.getPackageInfo("left-pad");searchFinds published npm packages by keyword through npm's public registry search.Arguments
Name Type Required querystringYes sizenumberNo Returns
npmjsSearchResult[]interface npmjsSearchResult { name: string; version: string; description: string | null; date: string | null; // ISO-8601 publisher: string | null; weeklyDownloads: number | null; maintainers: { username: string; email: string | null }[]; // npm's maintainer list, with the email each registered repository: string | null; // links.repository homepage: string | null; // links.homepage }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/npmjs/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npmjs.search("react", 2);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npmjs.search("react", 2))curl -X POST https://api.bowmark.ai/v1/sites/npmjs/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"react","size":2}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.npmjs.search("react", 2);
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/npmjs/<function> - OpenAPI
/v1/sites/npmjs/openapi.json