`search_packages`

Pack: npm · Endpoint: https://gateway.pipeworx.io/npm/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/search_packages for the schema, then POST the same URL with its arguments for the data.

Search npm for packages by keyword. Returns package names, descriptions, latest versions, publish dates, and publishers. Use when discovering libraries for a task.

Parameters

Name	Type	Required	Description
`query`	string	yes	Search query string
`limit`	number	no	Maximum number of results to return (default 10, max 50)

Example call

Arguments

{
  "query": "http server framework"
}

curl

curl -X POST https://gateway.pipeworx.io/npm/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_packages","arguments":{"query":"http server framework"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('search_packages', {
  "query": "http server framework"
});

More examples

{
  "query": "data validation",
  "limit": 20
}

Response shape

Always returns: total, packages

Field	Type	Description
`total`	number	Total number of matching packages in the registry
`packages`	array

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number",
      "description": "Total number of matching packages in the registry"
    },
    "packages": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Package name"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Package description or null"
          },
          "version": {
            "type": "string",
            "description": "Latest package version"
          },
          "date": {
            "type": "string",
            "description": "Publication date"
          },
          "publisher": {
            "type": [
              "string",
              "null"
            ],
            "description": "Publisher username or null"
          },
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Associated keywords"
          },
          "homepage": {
            "type": [
              "string",
              "null"
            ],
            "description": "Homepage URL or null"
          },
          "score": {
            "type": "number",
            "description": "Search relevance score (0-1 scale)"
          }
        },
        "required": [
          "name",
          "description",
          "version",
          "date",
          "publisher",
          "keywords",
          "homepage",
          "score"
        ]
      }
    }
  },
  "required": [
    "total",
    "packages"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "npm": {
      "url": "https://gateway.pipeworx.io/npm/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search_packages