---
name: NPM
version: 1.0.0
description: "The npm package registry for JavaScript/TypeScript packages"
homepage: https://registry.npmjs.org
metadata: {"seren":{"category":"integration","publisher_slug":"npm-registry","api_base":"https://api.serendb.com"}}
---

# NPM

The npm package registry for JavaScript/TypeScript packages

## API Endpoints

### GET `/-/v1/search`

Search for packages by text query

**Query Parameters:**
- `text`: string (required) - Search query
- `size`: integer - Results per page (max 250)

**Example:**

```bash
curl -X GET https://api.serendb.com/publishers/npm-registry/-/v1/search \
  -H "Authorization: Bearer $SEREN_API_KEY"
```

### GET `/{package}`

Get full package metadata including all versions

**Example:**

```bash
curl -X GET https://api.serendb.com/publishers/npm-registry/{package} \
  -H "Authorization: Bearer $SEREN_API_KEY"
```

### GET `/{package}/latest`

Get latest version metadata only

**Example:**

```bash
curl -X GET https://api.serendb.com/publishers/npm-registry/{package}/latest \
  -H "Authorization: Bearer $SEREN_API_KEY"
```

## MCP Tools

This API publisher also supports MCP (Model Context Protocol) access. Each API endpoint is available as an MCP tool.

### Available Tools

- `get_-_v1_search`: Search for packages by text query
- `get_by_package`: Get full package metadata including all versions
- `get_by_package_latest`: Get latest version metadata only

### Introspection

```bash
# List tools
curl https://api.serendb.com/publishers/npm-registry/_mcp/tools \
  -H "Authorization: Bearer $SEREN_API_KEY"

# Call a tool
curl -X POST https://api.serendb.com/publishers/npm-registry/_mcp/tools/{tool_name} \
  -H "Authorization: Bearer $SEREN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"body": {"key": "value"}}'
```

## Pricing

**Pricing Model:** per_request

- Price per request: $0

**Minimum charge:** $0.00010000

---

## Need Help?

- Seren Docs: https://docs.serendb.com
- Publisher: The npm package registry for JavaScript/TypeScript packages