# PkgGuard by AgentGate

> PkgGuard by AgentGate is a paid API for AI agents from api.youraitools.co, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-27).

Checks a specific version of an open-source package against the OSV.dev vulnerability database and returns a verdict with CVE details, severity scores, and fix versions.

## Facts

- Endpoint: GET https://api.youraitools.co/pkgguard/v1/package?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pkgguard-by-agentgate-d344a7fa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LGrZVHxdKGgWIsB1_UKEL

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 pkgguard-by-agentgate-d344a7fa
```

Example prompt: Can you check if lodash version 4.17.15 on npm has any known vulnerabilities — I need to know the severity and whether there's a fixed version I should upgrade to?

## When to prefer this

Choose PkgGuard when you need a quick, pay-per-call vulnerability check against OSV.dev for a specific package version without setting up your own OSV API integration. It is especially useful in agentic pipelines that need to gate on security verdict before installing or deploying a dependency, and when you need structured JSON output with severity and fix-version data. Prefer alternatives if you need bulk scanning of entire lock files, continuous monitoring, or a source beyond OSV.dev.

## Known failure modes

- Package name or version not found in OSV.dev — returns empty vulnerability list
- Unsupported ecosystem string — defaults to npm or returns error
- Missing required 'name' or 'version' query parameters — returns 400 error
- OSV.dev upstream unavailable — service may return 503 or timeout
- Version string must be exact — fuzzy or range versions may not match advisories correctly

## How this service works

Package vulnerability lookup API. Is this package version safe to install? Known vulnerabilities (CVE/GHSA ids, severity, CVSS score, fixed-in versions) and malicious-package flags for one npm, PyPI, Go, crates.io, Packagist, RubyGems, Maven or NuGet package version, from OSV.dev. Search intents: package vulnerability check, is this npm package safe, cve lookup api, pypi vulnerability, malicious package check, osv lookup.

## Output

A JSON object containing a verdict ('vulnerable' or 'safe'), a list of packages with per-package vulnerability details including CVE IDs, CVSS scores, severity tiers, affected versions, fix versions, malicious flags, and summary counts (advisory count, vulnerable count, malicious count, highest severity).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "name",
      "version"
     ],
     "properties": {
      "name": {
       "type": "string",
       "description": "Package name, e.g. lodash"
      },
      "version": {
       "type": "string",
       "description": "Exact version, e.g. 4.17.15"
      },
      "ecosystem": {
       "type": "string",
       "description": "One of npm, PyPI, Go, crates.io, Packagist, RubyGems, Maven, NuGet, Pub, Hex (default npm)"
      }
     },
     "description": "Search intents: package vulnerability check, is this npm package safe, cve lookup api, pypi vulnerability, malicious package check, osv lookup"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "tier": {
       "type": "string"
      },
      "source": {
       "type": "object"
      },
      "verdict": {
       "type": "string"
      },
      "packages": {
       "type": "array"
      },
      "disclaimer": {
       "type": "string"
      },
      "package_count": {
       "type": "number"
      },
      "scanned_count": {
       "type": "number"
      },
      "advisory_count": {
       "type": "number"
      },
      "unpinned_count": {
       "type": "number"
      },
      "malicious_count": {
       "type": "number"
      },
      "highest_severity": {
       "type": "string"
      },
      "vulnerable_count": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tier": "full",
  "source": {
   "name": "OSV.dev"
  },
  "verdict": "vulnerable",
  "packages": [
   {
    "name": "lodash",
    "vulns": [
     {
      "id": "GHSA-35jh-r3h4-6jhm",
      "url": "https://osv.dev/vulnerability/GHSA-35jh-r3h4-6jhm",
      "aliases": [
       "CVE-2021-23337"
      ],
      "summary": "Command Injection in lodash",
      "fixed_in": [
       "4.17.21"
      ],
      "severity": "HIGH",
      "malicious": false,
      "cvss_score": 7.2
     }
    ],
    "version": "4.17.15",
    "ecosystem": "npm",
    "malicious": false,
    "vuln_count": 6,
    "version_source": "exact",
    "highest_severity": "HIGH"
   }
  ],
  "disclaimer": "Informational: lists published advisories from OSV.dev for the versions given.",
  "package_count": 1,
  "scanned_count": 1,
  "advisory_count": 6,
  "unpinned_count": 0,
  "malicious_count": 0,
  "highest_severity": "HIGH",
  "vulnerable_count": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pkgguard-by-agentgate-d344a7fa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.youraitools.co](https://www.zero.xyz/host/api.youraitools.co/llms.txt)