# AgentsTools Package Preflight Batch Scanner

> AgentsTools Package Preflight Batch Scanner is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.15/call, status unknown (last checked 2026-09-15).

Runs install-safety preflight checks on a batch of up to 100 packages or a parsed dependency manifest, returning a per-package verdict and a blocked/caution/safe summary based on supply-chain indicators.

## Facts

- Endpoint: POST https://api.agentstools.dev/pkg/preflight/batch
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentstools-package-preflight-batch-scanner-e3d35c0c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FRqYd993AND_kQOr0iAo5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentstools-package-preflight-batch-scanner-e3d35c0c -d '<json body>'
```

Example prompt: Before I run npm install, can you do a supply-chain preflight check on these 20 packages from my package.json and tell me which ones are blocked, which need caution, and which are safe?

## When to prefer this

Choose this endpoint when you need to screen a full dependency list or parsed manifest in a single call rather than checking packages one by one. It is ideal for CI/CD pipeline gates, pre-install checks, and bulk audits where up to 100 packages must be evaluated quickly. Prefer it over single-package endpoints when processing requirements.txt, package.json, or lockfiles wholesale.

## Known failure modes

- Batch exceeds 100 packages — request rejected with limit error
- Malformed or unparseable manifest input — returns parsing error
- Unknown or very new packages may lack sufficient supply-chain data — low-confidence verdicts
- Network or upstream data source unavailability — 5xx error
- Payment not fulfilled via x402 — 402 Payment Required response

## How this service works

Batch install-safety preflight for a whole dependency list or parsed manifest (up to 100 packages). Returns a verdict per package plus a blocked / caution / safe summary. Supply-chain indicators, not a guarantee.

## Output

Returns a per-package verdict for each submitted package (blocked, caution, or safe) along with supply-chain indicator details, plus an aggregated batch summary showing counts and highlights across all packages. Results are advisory indicators, not guarantees.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "packages": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Package names; an entry may be 'name' or 'npm:name' / 'pypi:name', or an object with name + ecosystem"
  },
  "ecosystem": {
   "enum": [
    "npm",
    "pypi"
   ],
   "type": "string",
   "description": "Default ecosystem for entries that do not set one"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentstools-package-preflight-batch-scanner-e3d35c0c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)