/** * @fileoverview Tool for fetching one or more CVEs by ID from the NIST NVD API. * @module src/mcp-server/tools/definitions/nvd-get-cve */ import { z } from '@cyanheads/mcp-ts-core'; import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors'; /** * References rendered per CVE. A dense record runs to ~100 references at roughly 140 bytes a line * once the URL, its contributing source, and its tags are on it (CVE-2021-44228 carries 103, * ~14.4KB rendered in full). 15 covers the advisory/patch/exploit cluster a triage decision turns * on for ~2.3KB per record, and the trailer discloses the remainder that `structuredContent` * still carries in full. */ export declare const REFERENCE_CAP = 15; export declare const nvdGetCve: import("@cyanheads/mcp-ts-core").ToolDefinition]>; brief: z.ZodDefault; includeReferences: z.ZodDefault; allLanguages: z.ZodDefault; }, z.core.$strip>, z.ZodObject<{ brief: z.ZodBoolean; cves: z.ZodArray; descriptions: z.ZodOptional>>; cvssScores: z.ZodOptional; }, z.core.$strip>>>; severity: z.ZodOptional>; weaknesses: z.ZodOptional; }, z.core.$strip>>>; configurationNodes: z.ZodOptional; nodeOperator: z.ZodOptional; cpeMatch: z.ZodArray; versionStartExcluding: z.ZodOptional; versionEndIncluding: z.ZodOptional; versionEndExcluding: z.ZodOptional; }, z.core.$strip>>; }, z.core.$strip>>>; references: z.ZodOptional; tags: z.ZodOptional>; }, z.core.$strip>>>; cisaKev: z.ZodOptional>; description: z.ZodOptional; cisaVulnerabilityName: z.ZodOptional; }, z.core.$loose>>; }, z.core.$strip>, readonly [{ readonly reason: "invalid_cve_id_format"; readonly code: JsonRpcErrorCode.ValidationError; readonly when: "One or more CVE IDs fail format validation (NVD returns HTTP 404 for malformed IDs)."; readonly recovery: "Use the format CVE-YYYY-NNNNN (e.g., CVE-2021-44228) and verify each ID."; }, { readonly reason: "cve_not_found"; readonly code: JsonRpcErrorCode.NotFound; readonly when: "A valid-format CVE ID returns no results — the ID is well-formed but does not exist in NVD."; readonly recovery: "Verify the CVE ID is correct; use nvd_search_cves to search by keyword or date."; }, { readonly reason: "rate_limited"; readonly code: JsonRpcErrorCode.RateLimited; readonly when: "NVD returned HTTP 403 indicating the rate limit was exceeded."; readonly retryable: true; readonly recovery: "Wait for the NVD rate window to reset or set the NVD_API_KEY environment variable for higher limits."; }], { readonly requested: z.ZodNumber; readonly returned: z.ZodNumber; readonly missingIds: z.ZodOptional>; }>; //# sourceMappingURL=nvd-get-cve.tool.d.ts.map