@cyanheads/cpsc-recalls-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/cpsc-search-recalls.tool.js

@@ -0,0 +1,245 @@
+/**
+ * @fileoverview Search CPSC consumer product recalls by product name, brand, retailer,
+ * hazard keyword, or date range.
+ * @module mcp-server/tools/definitions/cpsc-search-recalls
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getCpscRecallService } from '../../../services/cpsc-recall/cpsc-recall-service.js';
+/** Static jurisdiction note included in every response. */
+const JURISDICTION = 'CPSC covers consumer products — toys, electronics, furniture, appliances, tools, clothing. ' +
+    'Does NOT cover: food/drugs (FDA), motor vehicles/tires (NHTSA), boats (USCG), pesticides (EPA), firearms (ATF). ' +
+    'For those categories, use the appropriate server.';
+export const cpscSearchRecalls = tool('cpsc_search_recalls', {
+    title: 'Search CPSC Recalls',
+    description: 'Search consumer product recalls from the CPSC (Consumer Product Safety Commission) database. ' +
+        "Covers toys, electronics, furniture, appliances, children's products, tools, and clothing — everything under CPSC jurisdiction. " +
+        'Does NOT cover food/drugs (FDA), motor vehicles/tires (NHTSA), boats (USCG), or pesticides (EPA). ' +
+        'All filter fields are optional substring matches that combine with AND. ' +
+        'For hazard-type filtering ("fire", "choking", "burn"), use description_search — the dedicated Hazard filter is non-functional in the upstream API. ' +
+        'When manufacturer returns no results, try importer or retailer: many recalls list the importer or retailer as the primary responsible org. ' +
+        'Use cpsc_get_recall with a recall_number from results to retrieve the full record including complete description, all images, and incident reports.',
+    annotations: { readOnlyHint: true, idempotentHint: true },
+    input: z.object({
+        product_name: z
+            .string()
+            .optional()
+            .describe('Product name to search for, e.g. "crib", "space heater", "bicycle". Substring match — partial names work.'),
+        manufacturer: z
+            .string()
+            .optional()
+            .describe('Manufacturer name, e.g. "Samsung", "LEGO". Substring match against the Manufacturers array. ' +
+            'Note: many recalls list the importer or retailer as the primary org rather than the manufacturer — try importer or retailer if this returns no results.'),
+        retailer: z
+            .string()
+            .optional()
+            .describe('Retailer name, e.g. "Walmart", "Target", "Amazon". Substring match against the retailer narrative (which includes store name, dates sold, and price).'),
+        importer: z
+            .string()
+            .optional()
+            .describe('Importer company name. Use when searching for recalls by the company that brought the product into the US.'),
+        description_search: z
+            .string()
+            .optional()
+            .describe('Keyword search within the recall Description field only (does not search Title or Hazards text). ' +
+            'Use for hazard types like "fire", "choking", "burn", or to find product details not captured in product_name. ' +
+            'Note: hazard keywords often appear in the Description field — this is the correct filter for hazard-type searching since the Hazard filter param is non-functional upstream.'),
+        date_start: z
+            .union([
+            z.literal(''),
+            z
+                .string()
+                .regex(/^\d{4}-\d{2}-\d{2}$/)
+                .describe('ISO 8601 date: "YYYY-MM-DD".'),
+        ])
+            .optional()
+            .describe('Include only recalls on or after this date. ISO 8601 format: "YYYY-MM-DD".'),
+        date_end: z
+            .union([
+            z.literal(''),
+            z
+                .string()
+                .regex(/^\d{4}-\d{2}-\d{2}$/)
+                .describe('ISO 8601 date: "YYYY-MM-DD".'),
+        ])
+            .optional()
+            .describe('Include only recalls on or before this date. ISO 8601 format: "YYYY-MM-DD".'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .default(20)
+            .describe('Maximum number of results to return (applied client-side — the API returns all matches). Defaults to 20.'),
+    }),
+    output: z.object({
+        recalls: z
+            .array(z
+            .object({
+            recall_number: z
+                .string()
+                .describe('Recall identifier (5-digit numeric for 2002+ records, e.g. "25043"; 6-char with letter suffix for 1998–2001 records, e.g. "99003a"). Pass to cpsc_get_recall for full detail.'),
+            recall_date: z.string().describe('Date the recall was issued, ISO 8601.'),
+            title: z.string().describe('Official recall title.'),
+            hazards: z
+                .array(z.string().describe('Hazard description — what is dangerous.'))
+                .describe('Hazard descriptions — what is dangerous about this product.'),
+            remedy_options: z
+                .array(z.string().describe('Remedy type.'))
+                .describe('Remedy types: Refund, Repair, Replace, Dispose, Label, New Instructions. Multiple may apply.'),
+            remedy_summary: z
+                .string()
+                .describe('Full remedy instructions — what the consumer should do and how to claim.'),
+            products: z
+                .array(z
+                .object({
+                name: z.string().describe('Product name.'),
+                units_recalled: z
+                    .string()
+                    .describe('Estimated number of units recalled, e.g. "About 2,500".'),
+            })
+                .describe('A product covered by this recall.'))
+                .describe('Products covered by this recall. A recall may cover multiple products.'),
+            upcs: z
+                .array(z.string().describe('UPC code.'))
+                .describe('UPC codes for this recall (sparse — ~4% of records have UPCs). ' +
+                'UPCs are stored at the recall level in the API, not per-product; ' +
+                'when a recall covers multiple products, all UPCs apply to the recall as a whole.'),
+            manufacturers: z
+                .array(z.string().describe('Manufacturer name.'))
+                .describe('Manufacturer names. Often empty — importer or retailer may be listed instead.'),
+            importers: z
+                .array(z.string().describe('Importer name.'))
+                .describe('Importer company names.'),
+            retailers: z
+                .array(z.string().describe('Retailer name and sale details.'))
+                .describe('Retailer names and sale details (narrative text including stores, dates, price range).'),
+            cpsc_url: z.string().describe('Official CPSC recall page URL for human verification.'),
+            images: z
+                .array(z
+                .object({
+                url: z.string().describe('Image URL.'),
+                caption: z.string().describe('Image caption.'),
+            })
+                .describe('An image from the recall notice.'))
+                .describe('Product images from the recall notice.'),
+        })
+            .describe('A CPSC recall record.'))
+            .describe('Matching recalls, ordered newest-first.'),
+        total_found: z.number().describe('Total matching records before the limit was applied.'),
+        truncated: z.boolean().describe('True when total_found exceeds the limit.'),
+        cpsc_jurisdiction: z
+            .string()
+            .describe('CPSC covers consumer products — toys, electronics, furniture, appliances, tools, clothing. ' +
+            'Does NOT cover: food/drugs (FDA), motor vehicles/tires (NHTSA), boats (USCG), pesticides (EPA), firearms (ATF).'),
+    }),
+    errors: [
+        {
+            reason: 'no_results',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No recalls matched the search filters',
+            recovery: 'Broaden the search — try a shorter product name, fewer filters, or remove the date range. Check CPSC jurisdiction: food, vehicle, and drug recalls are not in this database.',
+        },
+        {
+            reason: 'upstream_error',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'The saferproducts.gov API returned an error or timed out',
+            recovery: 'The CPSC API is occasionally unavailable. Retry in a few seconds.',
+            retryable: true,
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('Searching CPSC recalls', {
+            product_name: input.product_name,
+            manufacturer: input.manufacturer,
+            retailer: input.retailer,
+            importer: input.importer,
+            description_search: input.description_search,
+            date_start: input.date_start,
+            date_end: input.date_end,
+            limit: input.limit,
+        });
+        const svc = getCpscRecallService();
+        let raw;
+        try {
+            raw = await svc.search({
+                ...(input.product_name && { ProductName: input.product_name }),
+                ...(input.manufacturer && { Manufacturer: input.manufacturer }),
+                ...(input.retailer && { Retailer: input.retailer }),
+                ...(input.importer && { Importer: input.importer }),
+                ...(input.description_search && { RecallDescription: input.description_search }),
+                ...(input.date_start && { RecallDateStart: input.date_start }),
+                ...(input.date_end && { RecallDateEnd: input.date_end }),
+            }, ctx);
+        }
+        catch (err) {
+            throw ctx.fail('upstream_error', 'CPSC API request failed.', { ...ctx.recoveryFor('upstream_error') }, { cause: err });
+        }
+        if (raw.length === 0) {
+            throw ctx.fail('no_results', 'No recalls matched the search filters.', {
+                ...ctx.recoveryFor('no_results'),
+            });
+        }
+        const total_found = raw.length;
+        const slice = raw.slice(0, input.limit);
+        const truncated = total_found > input.limit;
+        const recalls = slice.map((r) => ({
+            recall_number: r.RecallNumber,
+            recall_date: r.RecallDate.slice(0, 10),
+            title: r.Title,
+            hazards: r.Hazards.map((h) => h.Name).filter(Boolean),
+            remedy_options: r.RemedyOptions.map((o) => o.Option).filter(Boolean),
+            remedy_summary: r.Remedies.map((rem) => rem.Name)
+                .filter(Boolean)
+                .join(' '),
+            products: r.Products.map((p) => ({
+                name: p.Name,
+                units_recalled: p.NumberOfUnits ?? '',
+            })),
+            upcs: r.ProductUPCs.map((u) => u.UPC).filter(Boolean),
+            manufacturers: r.Manufacturers.map((m) => m.Name).filter(Boolean),
+            importers: r.Importers.map((i) => i.Name).filter(Boolean),
+            retailers: r.Retailers.map((ret) => ret.Name).filter(Boolean),
+            cpsc_url: r.URL,
+            images: r.Images.map((img) => ({ url: img.URL, caption: img.Caption })),
+        }));
+        ctx.log.info('Search complete', { total_found, returned: recalls.length, truncated });
+        return { recalls, total_found, truncated, cpsc_jurisdiction: JURISDICTION };
+    },
+    format(result) {
+        const lines = [];
+        for (const r of result.recalls) {
+            lines.push(`## [${r.recall_number}] — ${r.title} (${r.recall_date})`);
+            const hazardText = r.hazards.length > 0 ? r.hazards.join('; ') : 'Not specified';
+            lines.push(`**Hazard:** ${hazardText}`);
+            const remedyTypes = r.remedy_options.length > 0 ? r.remedy_options.join(', ') : 'Not specified';
+            const remedyText = r.remedy_summary || 'See CPSC recall page.';
+            lines.push(`**Remedy:** ${remedyTypes} — ${remedyText}`);
+            const productNames = r.products
+                .map((p) => `${p.name} (${p.units_recalled || 'units not specified'})`)
+                .join(', ');
+            lines.push(`**Products:** ${productNames || 'Not specified'}`);
+            if (r.upcs.length > 0) {
+                lines.push(`**UPCs:** ${r.upcs.join(', ')}`);
+            }
+            const soldBy = r.retailers.length > 0 ? r.retailers.join('; ') : 'Not specified';
+            lines.push(`**Sold by:** ${soldBy}`);
+            const orgs = [...r.manufacturers, ...r.importers];
+            const orgText = orgs.length > 0 ? orgs.join(', ') : 'Not specified';
+            lines.push(`**Manufacturer/Importer:** ${orgText}`);
+            if (r.images.length > 0) {
+                const imgList = r.images.map((img) => `${img.caption}: ${img.url}`).join('; ');
+                lines.push(`**Images (${r.images.length}):** ${imgList}`);
+            }
+            else {
+                lines.push(`**Images:** None`);
+            }
+            lines.push(`[View recall](${r.cpsc_url})`);
+            lines.push('---');
+        }
+        lines.push(`Showing ${result.recalls.length} of ${result.total_found} recalls.${result.truncated ? ' Results truncated — narrow by date or filter to see more.' : ''}`);
+        lines.push(`CPSC covers: ${result.cpsc_jurisdiction}`);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=cpsc-search-recalls.tool.js.map

package/dist/mcp-server/tools/definitions/cpsc-search-recalls.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpsc-search-recalls.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/cpsc-search-recalls.tool.ts"],"names":[],"mappings":"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"}

package/dist/services/cpsc-recall/cpsc-recall-service.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Service for fetching consumer product recall data from the CPSC
+ * saferproducts.gov REST API. Keyless, stateless per-request fetches.
+ * @module services/cpsc-recall/cpsc-recall-service
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import type { CpscSearchParams, RawRecall } from './types.js';
+export declare class CpscRecallService {
+    /**
+     * Search recalls by filter params. Returns all matching records (the API has no
+     * server-side pagination); client-side limiting must be applied by callers.
+     */
+    search(params: CpscSearchParams, ctx: Context): Promise<RawRecall[]>;
+    /**
+     * Fetch a single recall by recall number. Returns `null` when no matching record
+     * exists (API returns empty array for unknown numbers).
+     */
+    getByNumber(recallNumber: string, ctx: Context): Promise<RawRecall | null>;
+    /**
+     * Fetch recalls within a date window. The date range is required — passing no
+     * dates returns all 9,828+ records, which is too large to be useful.
+     */
+    getRecent(dateStart: string, dateEnd: string, ctx: Context): Promise<RawRecall[]>;
+    private buildUrl;
+    private fetchRecalls;
+}
+export declare function initCpscRecallService(): void;
+export declare function getCpscRecallService(): CpscRecallService;
+//# sourceMappingURL=cpsc-recall-service.d.ts.map

package/dist/services/cpsc-recall/cpsc-recall-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpsc-recall-service.d.ts","sourceRoot":"","sources":["../../../src/services/cpsc-recall/cpsc-recall-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM9D,qBAAa,iBAAiB;IAC5B;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAapE;;;OAGG;IACG,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAMhF;;;OAGG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAKjF,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,YAAY;CAoCrB;AAMD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,CAKxD"}

package/dist/services/cpsc-recall/cpsc-recall-service.js

@@ -0,0 +1,97 @@
+/**
+ * @fileoverview Service for fetching consumer product recall data from the CPSC
+ * saferproducts.gov REST API. Keyless, stateless per-request fetches.
+ * @module services/cpsc-recall/cpsc-recall-service
+ */
+import { serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
+import { fetchWithTimeout, requestContextService, withRetry } from '@cyanheads/mcp-ts-core/utils';
+const BASE_URL = 'https://www.saferproducts.gov/RestWebServices/Recall';
+/** Request timeout: 30 s. The API returns full datasets; allow enough time. */
+const TIMEOUT_MS = 30_000;
+export class CpscRecallService {
+    /**
+     * Search recalls by filter params. Returns all matching records (the API has no
+     * server-side pagination); client-side limiting must be applied by callers.
+     */
+    search(params, ctx) {
+        const url = this.buildUrl({
+            ProductName: params.ProductName,
+            Manufacturer: params.Manufacturer,
+            Retailer: params.Retailer,
+            Importer: params.Importer,
+            RecallDescription: params.RecallDescription,
+            RecallDateStart: params.RecallDateStart,
+            RecallDateEnd: params.RecallDateEnd,
+        });
+        return this.fetchRecalls(url, ctx);
+    }
+    /**
+     * Fetch a single recall by recall number. Returns `null` when no matching record
+     * exists (API returns empty array for unknown numbers).
+     */
+    async getByNumber(recallNumber, ctx) {
+        const url = this.buildUrl({ RecallNumber: recallNumber });
+        const results = await this.fetchRecalls(url, ctx);
+        return results[0] ?? null;
+    }
+    /**
+     * Fetch recalls within a date window. The date range is required — passing no
+     * dates returns all 9,828+ records, which is too large to be useful.
+     */
+    getRecent(dateStart, dateEnd, ctx) {
+        const url = this.buildUrl({ RecallDateStart: dateStart, RecallDateEnd: dateEnd });
+        return this.fetchRecalls(url, ctx);
+    }
+    buildUrl(params) {
+        const qs = new URLSearchParams({ format: 'json' });
+        for (const [key, value] of Object.entries(params)) {
+            if (value !== undefined && value !== '')
+                qs.set(key, value);
+        }
+        return `${BASE_URL}?${qs.toString()}`;
+    }
+    fetchRecalls(url, ctx) {
+        const reqCtx = requestContextService.createRequestContext({
+            operation: 'CpscRecallService.fetchRecalls',
+            requestId: ctx.requestId,
+        });
+        return withRetry(async () => {
+            const response = await fetchWithTimeout(url, TIMEOUT_MS, reqCtx, {
+                signal: ctx.signal,
+            });
+            const text = await response.text();
+            // Some upstream error pages return HTTP 200 with HTML.
+            if (/^\s*<(!DOCTYPE\s+html|html[\s>])/i.test(text)) {
+                throw serviceUnavailable('CPSC API returned HTML instead of JSON — likely a transient service issue.');
+            }
+            let data;
+            try {
+                data = JSON.parse(text);
+            }
+            catch {
+                throw serviceUnavailable('CPSC API returned unparseable response.');
+            }
+            if (!Array.isArray(data)) {
+                throw serviceUnavailable('CPSC API response was not a JSON array.');
+            }
+            return data;
+        }, {
+            operation: 'CpscRecallService.fetchRecalls',
+            context: reqCtx,
+            baseDelayMs: 500,
+            signal: ctx.signal,
+        });
+    }
+}
+// --- Init/accessor pattern ---
+let _service;
+export function initCpscRecallService() {
+    _service = new CpscRecallService();
+}
+export function getCpscRecallService() {
+    if (!_service) {
+        throw new Error('CpscRecallService not initialized — call initCpscRecallService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=cpsc-recall-service.js.map

package/dist/services/cpsc-recall/cpsc-recall-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpsc-recall-service.js","sourceRoot":"","sources":["../../../src/services/cpsc-recall/cpsc-recall-service.ts"],"names":[],"mappings":"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"}

package/dist/services/cpsc-recall/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @fileoverview Raw API response types from the CPSC saferproducts.gov recall endpoint.
+ * @module services/cpsc-recall/types
+ */
+/** Raw recall record as returned by the CPSC REST API. */
+export interface RawRecall {
+    ConsumerContact: string | null;
+    Description: string;
+    Distributors: Array<{
+        Name: string;
+        CompanyID: string;
+    }>;
+    Hazards: Array<{
+        Name: string;
+        HazardType: string;
+        HazardTypeID: string;
+    }>;
+    Images: Array<{
+        URL: string;
+        Caption: string;
+    }>;
+    Importers: Array<{
+        Name: string;
+        CompanyID: string;
+    }>;
+    /** Coordinated recalls from other agencies (e.g. Canada Health). */
+    Inconjunctions: Array<{
+        URL: string;
+    }>;
+    Injuries: Array<{
+        Name: string;
+    }>;
+    LastPublishDate: string;
+    ManufacturerCountries: Array<{
+        Country: string;
+    }>;
+    Manufacturers: Array<{
+        Name: string;
+        CompanyID: string;
+    }>;
+    Products: RawProduct[];
+    /** Sparse (~4% of records). UPCs are at recall level, not per-product. */
+    ProductUPCs: Array<{
+        UPC: string;
+    }>;
+    RecallDate: string;
+    RecallID: number;
+    RecallNumber: string;
+    Remedies: Array<{
+        Name: string;
+    }>;
+    RemedyOptions: Array<{
+        Option: string;
+    }>;
+    Retailers: Array<{
+        Name: string;
+        CompanyID: string;
+    }>;
+    /** Always null in practice — omitted from output. */
+    SoldAtLabel: null;
+    Title: string;
+    URL: string;
+}
+export interface RawProduct {
+    /** Always empty. */
+    CategoryID: string;
+    /** Always empty in full dataset. */
+    Description: string;
+    /** Almost always empty — model info is in Description text instead. */
+    Model: string;
+    Name: string;
+    NumberOfUnits: string;
+    Type: string;
+}
+/** Parameters for the CPSC search endpoint. */
+export interface CpscSearchParams {
+    Importer?: string;
+    Manufacturer?: string;
+    ProductName?: string;
+    RecallDateEnd?: string;
+    RecallDateStart?: string;
+    /** Maps to RecallDescription — searches the Description field only. */
+    RecallDescription?: string;
+    Retailer?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/cpsc-recall/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/cpsc-recall/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACxB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,MAAM,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,oEAAoE;IACpE,cAAc,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvC,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,0EAA0E;IAC1E,WAAW,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClC,aAAa,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzC,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,qDAAqD;IACrD,WAAW,EAAE,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/services/cpsc-recall/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Raw API response types from the CPSC saferproducts.gov recall endpoint.
+ * @module services/cpsc-recall/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/cpsc-recall/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/cpsc-recall/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "@cyanheads/cpsc-recalls-mcp-server",
+  "version": "0.1.1",
+  "mcpName": "io.github.cyanheads/cpsc-recalls-mcp-server",
+  "description": "MCP server for US consumer product recalls from the Consumer Product Safety Commission — hazards, remedies, and affected products.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "cpsc-recalls-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "changelog/",
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "CLAUDE.md",
+    "AGENTS.md",
+    "Dockerfile",
+    "server.json"
+  ],
+  "scripts": {
+    "build": "bun run scripts/build.ts",
+    "rebuild": "bun run scripts/clean.ts && bun run scripts/build.ts",
+    "clean": "bun run scripts/clean.ts",
+    "devcheck": "bun run scripts/devcheck.ts",
+    "audit:refresh": "rm -f bun.lock && bun install && bun audit",
+    "tree": "bun run scripts/tree.ts",
+    "list-skills": "bun run scripts/list-skills.ts",
+    "format": "biome check --write .",
+    "format:unsafe": "biome check --write --unsafe .",
+    "lint:mcp": "bun run scripts/lint-mcp.ts",
+    "lint:packaging": "bun run scripts/lint-packaging.ts",
+    "bundle": "bun run build && npx -y @anthropic-ai/mcpb pack . dist/cpsc-recalls-mcp-server.mcpb",
+    "changelog:build": "bun run scripts/build-changelog.ts",
+    "changelog:check": "bun run scripts/build-changelog.ts --check",
+    "release:github": "bun run scripts/release-github.ts",
+    "test": "bunx vitest run",
+    "publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
+    "start": "bun ./dist/index.js",
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio bun ./dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http bun ./dist/index.js"
+  },
+  "keywords": [
+    "cpsc",
+    "consumer-product-safety",
+    "recalls",
+    "product-safety",
+    "hazards",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "typescript",
+    "bun",
+    "stdio",
+    "streamable-http",
+    "ai-agent"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cyanheads/cpsc-recalls-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cyanheads/cpsc-recalls-mcp-server/issues"
+  },
+  "homepage": "https://github.com/cyanheads/cpsc-recalls-mcp-server#readme",
+  "author": "cyanheads <casey@caseyjhand.com> (https://github.com/cyanheads)",
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/cyanheads"
+    },
+    {
+      "type": "buy_me_a_coffee",
+      "url": "https://www.buymeacoffee.com/cyanheads"
+    }
+  ],
+  "license": "Apache-2.0",
+  "packageManager": "bun@1.3.11",
+  "engines": {
+    "bun": ">=1.3.0",
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cyanheads/mcp-ts-core": "^0.9.19",
+    "pino-pretty": "^13.1.3",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.7",
+    "@types/node": "^25.6.0",
+    "depcheck": "^1.4.7",
+    "ignore": "^7.0.5",
+    "tsc-alias": "^1.8.16",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.8"
+  }
+}