Use before a coding agent installs an unfamiliar npm dependency
Use before a coding agent installs an unfamiliar npm dependency. Returns current facts from the official npm registry: the version `npm install` resolves (dist-tags.latest), prerelease and deprecation status, engines.node compatibility with an optional target Node version (real SemVer evaluation), license, days since release, best-effort weekly downloads, repository URL and maintainer count. Facts only — no safety, trust, or malware verdict.
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://agent-api-production.tim1712.workers.dev/v1/npm/install-preflight
| Category | Company and compliance |
|---|---|
| Provider host | agent-api-production.tim1712.workers.dev |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 2 from 2 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-09-24 | valid payment request | 402 | $0.005 | 368 ms |
Example input (from the provider)
{
"body": {
"nodeVersion": "22.14.0",
"packageName": "zod"
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": false,
"properties": {
"nodeVersion": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"packageName": {
"maxLength": 214,
"minLength": 1,
"pattern": "^(?:@[a-z0-9][a-z0-9._-]*\\/)?[a-z0-9][a-z0-9._-]*$",
"type": "string"
}
},
"required": [
"packageName"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"additionalProperties": false,
"properties": {
"checkedAt": {
"type": "string"
},
"daysSinceRelease": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"deprecated": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"deprecationMessage": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"enginesNode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"found": {
"type": "boolean"
},
"homepage": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"latestIsPrerelease": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"latestVersion": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"license": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"maintainerCount": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"nodeCompatible": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"packageName": {
"type": "string"
},
"publishedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"repositoryUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"requestedNodeVersion": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"source": {
"const": "npm",
"type": "string"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
},
"weeklyDownloads": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
}
},
"required": [
"packageName",
"found",
"latestVersion",
"latestIsPrerelease",
"deprecated",
"deprecationMessage",
"enginesNode",
"requestedNodeVersion",
"nodeCompatible",
"license",
"publishedAt",
"daysSinceRelease",
"weeklyDownloads",
"repositoryUrl",
"homepage",
"maintainerCount",
"source",
"warnings",
"checkedAt"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}