@cyanheads/openfda-mcp-server 0.1.6

package/dist/mcp-server/tools/definitions/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @fileoverview Barrel export for all openFDA tool definitions.
+ * @module mcp-server/tools/definitions
+ */
+export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    endpoint: import("zod").ZodEnum<{
+        "drug/event": "drug/event";
+        "drug/label": "drug/label";
+        "drug/enforcement": "drug/enforcement";
+        "drug/ndc": "drug/ndc";
+        "drug/drugsfda": "drug/drugsfda";
+        "drug/shortages": "drug/shortages";
+        "food/event": "food/event";
+        "food/enforcement": "food/enforcement";
+        "device/event": "device/event";
+        "device/510k": "device/510k";
+        "device/pma": "device/pma";
+        "device/recall": "device/recall";
+        "device/enforcement": "device/enforcement";
+        "device/classification": "device/classification";
+        "device/registrationlisting": "device/registrationlisting";
+        "device/udi": "device/udi";
+        "device/covid19serology": "device/covid19serology";
+        "animalandveterinary/event": "animalandveterinary/event";
+        "other/substance": "other/substance";
+    }>;
+    count: import("zod").ZodString;
+    search: import("zod").ZodOptional<import("zod").ZodString>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    meta: import("zod").ZodObject<{
+        lastUpdated: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>;
+    results: import("zod").ZodArray<import("zod").ZodObject<{
+        term: import("zod").ZodString;
+        count: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>>;
+    message: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    search: import("zod").ZodString;
+    sort: import("zod").ZodOptional<import("zod").ZodString>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+    skip: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    meta: import("zod").ZodObject<{
+        total: import("zod").ZodNumber;
+        skip: import("zod").ZodNumber;
+        limit: import("zod").ZodNumber;
+        lastUpdated: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>;
+    results: import("zod").ZodArray<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>>;
+    message: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    search: import("zod").ZodOptional<import("zod").ZodString>;
+    sort: import("zod").ZodOptional<import("zod").ZodString>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+    skip: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    meta: import("zod").ZodObject<{
+        total: import("zod").ZodNumber;
+        skip: import("zod").ZodNumber;
+        limit: import("zod").ZodNumber;
+        lastUpdated: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>;
+    results: import("zod").ZodArray<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>>;
+    message: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>>)[];
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/tools/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAQ9B,CAAC"}

package/dist/mcp-server/tools/definitions/index.js

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Barrel export for all openFDA tool definitions.
+ * @module mcp-server/tools/definitions
+ */
+import { countTool } from './count.tool.js';
+import { getDrugLabelTool } from './get-drug-label.tool.js';
+import { lookupNdcTool } from './lookup-ndc.tool.js';
+import { searchAdverseEventsTool } from './search-adverse-events.tool.js';
+import { searchDeviceClearancesTool } from './search-device-clearances.tool.js';
+import { searchDrugApprovalsTool } from './search-drug-approvals.tool.js';
+import { searchRecallsTool } from './search-recalls.tool.js';
+export const allToolDefinitions = [
+    searchAdverseEventsTool,
+    searchRecallsTool,
+    countTool,
+    getDrugLabelTool,
+    searchDrugApprovalsTool,
+    searchDeviceClearancesTool,
+    lookupNdcTool,
+];
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/tools/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,uBAAuB;IACvB,iBAAiB;IACjB,SAAS;IACT,gBAAgB;IAChB,uBAAuB;IACvB,0BAA0B;IAC1B,aAAa;CACd,CAAC"}

package/dist/mcp-server/tools/definitions/lookup-ndc.tool.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview MCP tool for looking up drugs in the openFDA NDC (National Drug Code) Directory.
+ * @module mcp-server/tools/definitions/lookup-ndc
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const lookupNdcTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    search: z.ZodString;
+    sort: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    skip: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    meta: z.ZodObject<{
+        total: z.ZodNumber;
+        skip: z.ZodNumber;
+        limit: z.ZodNumber;
+        lastUpdated: z.ZodString;
+    }, z.core.$strip>;
+    results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+//# sourceMappingURL=lookup-ndc.tool.d.ts.map

package/dist/mcp-server/tools/definitions/lookup-ndc.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup-ndc.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/lookup-ndc.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGjD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;kBA8GxB,CAAC"}

package/dist/mcp-server/tools/definitions/lookup-ndc.tool.js

@@ -0,0 +1,101 @@
+/**
+ * @fileoverview MCP tool for looking up drugs in the openFDA NDC (National Drug Code) Directory.
+ * @module mcp-server/tools/definitions/lookup-ndc
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getOpenFdaService } from '../../../services/openfda/openfda-service.js';
+export const lookupNdcTool = tool('openfda_lookup_ndc', {
+    description: 'Look up drugs in the NDC (National Drug Code) Directory. Identify drug products by NDC code, find active ingredients, packaging details, or manufacturer info.',
+    annotations: { readOnlyHint: true },
+    input: z.object({
+        search: z
+            .string()
+            .describe('openFDA search query. Examples: product_ndc:"0363-0218", brand_name:"aspirin", generic_name:"metformin", openfda.manufacturer_name:"walgreen", active_ingredients.name:"ASPIRIN"'),
+        sort: z
+            .string()
+            .optional()
+            .describe('Sort field and direction. Example: listing_expiration_date:desc'),
+        limit: z
+            .number()
+            .min(1)
+            .max(1000)
+            .default(10)
+            .describe('Maximum number of records to return (1-1000, default 10)'),
+        skip: z
+            .number()
+            .min(0)
+            .max(25000)
+            .default(0)
+            .describe('Number of records to skip for pagination (0-25000, default 0)'),
+    }),
+    output: z.object({
+        meta: z
+            .object({
+            total: z.number().describe('Total matching records'),
+            skip: z.number().describe('Pagination offset'),
+            limit: z.number().describe('Records returned'),
+            lastUpdated: z.string().describe('Dataset last updated date'),
+        })
+            .describe('Response metadata'),
+        results: z
+            .array(z.record(z.string(), z.any()))
+            .describe('NDC directory records with product and packaging details'),
+        message: z
+            .string()
+            .optional()
+            .describe('Guidance when results are empty or search can be refined'),
+    }),
+    async handler(input, ctx) {
+        const service = getOpenFdaService();
+        const response = await service.query('drug/ndc', input, ctx);
+        ctx.log.info('NDC lookup completed', {
+            search: input.search,
+            total: response.meta.total,
+            returned: response.results.length,
+        });
+        return {
+            meta: response.meta,
+            results: response.results,
+            message: response.results.length === 0
+                ? 'No NDC records matched the query. Try broadening the search — use brand_name, generic_name, or active_ingredients.name fields.'
+                : undefined,
+        };
+    },
+    format: (result) => {
+        if (result.results.length === 0) {
+            return [{ type: 'text', text: result.message ?? 'No NDC records found.' }];
+        }
+        const lines = [
+            `**${result.meta.total.toLocaleString()} total results** (showing ${result.results.length}, skip: ${result.meta.skip}) | Data updated: ${result.meta.lastUpdated}\n`,
+        ];
+        for (const r of result.results) {
+            const title = r.brand_name ?? r.generic_name ?? r.product_ndc ?? 'Unknown';
+            lines.push(`### ${title}`);
+            lines.push(`**NDC:** ${r.product_ndc ?? 'N/A'} | **Labeler:** ${r.labeler_name ?? 'N/A'}`);
+            if (r.generic_name && r.brand_name)
+                lines.push(`**Generic:** ${r.generic_name}`);
+            if (r.dosage_form)
+                lines.push(`**Form:** ${r.dosage_form}${r.route ? ` | **Route:** ${(Array.isArray(r.route) ? r.route : [r.route]).join(', ')}` : ''}`);
+            if (r.marketing_category)
+                lines.push(`**Category:** ${r.marketing_category}`);
+            const ingredients = r.active_ingredients ?? [];
+            if (ingredients.length > 0) {
+                lines.push(`**Active ingredients:** ${ingredients.map((i) => `${i.name}${i.strength ? ` (${i.strength})` : ''}`).join(', ')}`);
+            }
+            const packaging = r.packaging ?? [];
+            if (packaging.length > 0) {
+                lines.push(`**Packaging:**`);
+                for (const p of packaging.slice(0, 5)) {
+                    lines.push(`- ${p.package_ndc ?? ''}: ${p.description ?? 'N/A'}`);
+                }
+                if (packaging.length > 5)
+                    lines.push(`- ... and ${packaging.length - 5} more`);
+            }
+            if (r.listing_expiration_date)
+                lines.push(`**Listing expires:** ${r.listing_expiration_date}`);
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=lookup-ndc.tool.js.map

package/dist/mcp-server/tools/definitions/lookup-ndc.tool.js.map

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

package/dist/mcp-server/tools/definitions/search-adverse-events.tool.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Tool definition for searching openFDA adverse event reports across drugs, food, and devices.
+ * @module mcp-server/tools/definitions/search-adverse-events
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const searchAdverseEventsTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    category: z.ZodEnum<{
+        drug: "drug";
+        food: "food";
+        device: "device";
+    }>;
+    search: z.ZodOptional<z.ZodString>;
+    sort: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    skip: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    meta: z.ZodObject<{
+        total: z.ZodNumber;
+        skip: z.ZodNumber;
+        limit: z.ZodNumber;
+        lastUpdated: z.ZodString;
+    }, z.core.$strip>;
+    results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+//# sourceMappingURL=search-adverse-events.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-adverse-events.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-adverse-events.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-adverse-events.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGjD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;kBAuKlC,CAAC"}

package/dist/mcp-server/tools/definitions/search-adverse-events.tool.js

@@ -0,0 +1,147 @@
+/**
+ * @fileoverview Tool definition for searching openFDA adverse event reports across drugs, food, and devices.
+ * @module mcp-server/tools/definitions/search-adverse-events
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getOpenFdaService } from '../../../services/openfda/openfda-service.js';
+export const searchAdverseEventsTool = tool('openfda_search_adverse_events', {
+    description: 'Search adverse event reports across drugs, food, and devices. Use to investigate safety signals, find reports for a specific product, or explore reactions by demographics.',
+    annotations: { readOnlyHint: true },
+    input: z.object({
+        category: z
+            .enum(['drug', 'food', 'device'])
+            .describe('Product category — each has different field schemas in the response'),
+        search: z
+            .string()
+            .optional()
+            .describe('Elasticsearch query string. Examples: patient.drug.medicinalproduct:"aspirin", patient.reaction.reactionmeddrapt:"nausea" AND serious:"1". Omit to browse recent.'),
+        sort: z.string().optional().describe('Sort field and direction. Example: receivedate:desc'),
+        limit: z
+            .number()
+            .min(1)
+            .max(1000)
+            .default(10)
+            .describe('Maximum number of records to return (1-1000, default 10)'),
+        skip: z
+            .number()
+            .min(0)
+            .max(25000)
+            .default(0)
+            .describe('Number of records to skip for pagination (0-25000, default 0)'),
+    }),
+    output: z.object({
+        meta: z
+            .object({
+            total: z.number().describe('Total matching records in the database'),
+            skip: z.number().describe('Pagination offset'),
+            limit: z.number().describe('Records returned in this response'),
+            lastUpdated: z.string().describe('Dataset last updated date'),
+        })
+            .describe('Response metadata'),
+        results: z
+            .array(z.record(z.string(), z.any()))
+            .describe('Adverse event records — fields vary by category (drug: patient/reactions/drugs, device: device details/event type, food: products/outcomes)'),
+        message: z
+            .string()
+            .optional()
+            .describe('Guidance when results are empty or search can be refined'),
+    }),
+    async handler(input, ctx) {
+        const svc = getOpenFdaService();
+        const endpoint = `${input.category}/event`;
+        const response = await svc.query(endpoint, {
+            search: input.search,
+            sort: input.sort,
+            limit: input.limit,
+            skip: input.skip,
+        }, ctx);
+        ctx.log.info('Adverse event search completed', {
+            category: input.category,
+            total: response.meta.total,
+            returned: response.results.length,
+        });
+        if (response.results.length === 0) {
+            return {
+                ...response,
+                message: `No adverse event reports matched${input.search ? ` search: ${input.search}` : ''} in ${input.category}/event. Try broadening filters, checking field names (use openfda.brand_name for product searches), or removing date constraints.`,
+            };
+        }
+        return response;
+    },
+    format: (result) => {
+        if (result.results.length === 0) {
+            return [{ type: 'text', text: result.message ?? 'No results found.' }];
+        }
+        const lines = [
+            `**${result.meta.total.toLocaleString()} total results** (showing ${result.results.length}, skip: ${result.meta.skip}) | Data updated: ${result.meta.lastUpdated}\n`,
+        ];
+        for (const r of result.results) {
+            // Drug adverse events
+            if (r.patient) {
+                const patient = r.patient;
+                const reactions = (patient.reaction ?? [])
+                    .map((rx) => rx.reactionmeddrapt)
+                    .filter(Boolean)
+                    .join(', ');
+                const drugs = (patient.drug ?? [])
+                    .map((d) => {
+                    const char = d.drugcharacterization === '1'
+                        ? 'Suspect'
+                        : d.drugcharacterization === '2'
+                            ? 'Concomitant'
+                            : d.drugcharacterization === '3'
+                                ? 'Interacting'
+                                : '';
+                    return `${d.medicinalproduct ?? 'Unknown'}${char ? ` (${char})` : ''}`;
+                })
+                    .join(', ');
+                lines.push(`### Report ${r.safetyreportid ?? 'N/A'}`);
+                lines.push(`**Date:** ${r.receivedate ?? 'N/A'} | **Serious:** ${r.serious === '1' ? 'Yes' : r.serious === '2' ? 'No' : (r.serious ?? 'N/A')}`);
+                if (patient.patientsex)
+                    lines.push(`**Patient:** Sex ${patient.patientsex === '1' ? 'Male' : patient.patientsex === '2' ? 'Female' : patient.patientsex}`);
+                if (reactions)
+                    lines.push(`**Reactions:** ${reactions}`);
+                if (drugs)
+                    lines.push(`**Drugs:** ${drugs}`);
+            }
+            // Device adverse events
+            else if (r.device) {
+                lines.push(`### Report ${r.report_number ?? r.mdr_report_key ?? 'N/A'}`);
+                if (r.event_type)
+                    lines.push(`**Event type:** ${r.event_type}`);
+                for (const d of Array.isArray(r.device) ? r.device : []) {
+                    lines.push(`**Device:** ${d.brand_name ?? d.generic_name ?? 'Unknown'}${d.manufacturer_d_name ? ` by ${d.manufacturer_d_name}` : ''}`);
+                }
+                const texts = (r.mdr_text ?? [])
+                    .slice(0, 2)
+                    .map((t) => t.text)
+                    .filter(Boolean);
+                if (texts.length) {
+                    const narrative = texts.join(' ');
+                    lines.push(`**Narrative:** ${narrative.length > 500 ? `${narrative.slice(0, 500)}...` : narrative}`);
+                }
+            }
+            // Food adverse events
+            else if (r.products || r.reactions) {
+                lines.push(`### Report ${r.report_number ?? 'N/A'}`);
+                if (r.reactions)
+                    lines.push(`**Reactions:** ${(Array.isArray(r.reactions) ? r.reactions : [r.reactions]).join(', ')}`);
+                if (r.outcomes)
+                    lines.push(`**Outcomes:** ${(Array.isArray(r.outcomes) ? r.outcomes : [r.outcomes]).join(', ')}`);
+                const products = (r.products ?? [])
+                    .map((p) => p.name_brand ?? p.industry_name ?? 'Unknown')
+                    .join(', ');
+                if (products)
+                    lines.push(`**Products:** ${products}`);
+            }
+            // Fallback
+            else {
+                lines.push(`### Record`);
+                lines.push(`\`\`\`json\n${JSON.stringify(r, null, 2).slice(0, 500)}\n\`\`\``);
+            }
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-adverse-events.tool.js.map

package/dist/mcp-server/tools/definitions/search-adverse-events.tool.js.map

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

package/dist/mcp-server/tools/definitions/search-device-clearances.tool.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Tool for searching FDA device premarket notifications (510(k) clearances and PMA approvals).
+ * @module mcp-server/tools/definitions/search-device-clearances
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const searchDeviceClearancesTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    pathway: z.ZodEnum<{
+        "510k": "510k";
+        pma: "pma";
+    }>;
+    search: z.ZodOptional<z.ZodString>;
+    sort: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    skip: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    meta: z.ZodObject<{
+        total: z.ZodNumber;
+        skip: z.ZodNumber;
+        limit: z.ZodNumber;
+        lastUpdated: z.ZodString;
+    }, z.core.$strip>;
+    results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+//# sourceMappingURL=search-device-clearances.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-device-clearances.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-device-clearances.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-device-clearances.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGjD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;kBA4HrC,CAAC"}

package/dist/mcp-server/tools/definitions/search-device-clearances.tool.js

@@ -0,0 +1,108 @@
+/**
+ * @fileoverview Tool for searching FDA device premarket notifications (510(k) clearances and PMA approvals).
+ * @module mcp-server/tools/definitions/search-device-clearances
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getOpenFdaService } from '../../../services/openfda/openfda-service.js';
+export const searchDeviceClearancesTool = tool('openfda_search_device_clearances', {
+    description: 'Search FDA device premarket notifications — 510(k) clearances and PMA approvals.',
+    annotations: { readOnlyHint: true },
+    input: z.object({
+        pathway: z
+            .enum(['510k', 'pma'])
+            .describe('Premarket pathway. 510(k) is most common (174K+ records). PMA is for higher-risk devices.'),
+        search: z
+            .string()
+            .optional()
+            .describe('openFDA search query. Examples: applicant:"medtronic", advisory_committee_description:"cardiovascular", product_code:"DXN", openfda.device_name:"catheter". Omit to browse recent.'),
+        sort: z.string().optional().describe('Sort expression. Example: decision_date:desc.'),
+        limit: z
+            .number()
+            .min(1)
+            .max(1000)
+            .default(10)
+            .describe('Maximum number of records to return (1-1000).'),
+        skip: z.number().min(0).max(25000).default(0).describe('Pagination offset (0-25000).'),
+    }),
+    output: z.object({
+        meta: z
+            .object({
+            total: z.number().describe('Total matching records'),
+            skip: z.number().describe('Pagination offset'),
+            limit: z.number().describe('Records returned'),
+            lastUpdated: z.string().describe('Dataset last updated date'),
+        })
+            .describe('Response metadata'),
+        results: z
+            .array(z.record(z.string(), z.any()))
+            .describe('510(k) clearance or PMA approval records'),
+        message: z
+            .string()
+            .optional()
+            .describe('Guidance when results are empty or search can be refined'),
+    }),
+    async handler(input, ctx) {
+        const service = getOpenFdaService();
+        const response = await service.query(`device/${input.pathway}`, {
+            search: input.search,
+            sort: input.sort,
+            limit: input.limit,
+            skip: input.skip,
+        }, ctx);
+        ctx.log.info('Device clearance search completed', {
+            pathway: input.pathway,
+            total: response.meta.total,
+            returned: response.results.length,
+        });
+        return {
+            meta: response.meta,
+            results: response.results,
+            message: response.results.length === 0
+                ? 'No matching device clearances found. Try broadening the search — use applicant, product_code, advisory_committee_description, or openfda.device_name fields.'
+                : undefined,
+        };
+    },
+    format: (result) => {
+        if (result.results.length === 0) {
+            return [{ type: 'text', text: result.message ?? 'No device clearances found.' }];
+        }
+        const lines = [
+            `**${result.meta.total.toLocaleString()} total results** (showing ${result.results.length}, skip: ${result.meta.skip}) | Data updated: ${result.meta.lastUpdated}\n`,
+        ];
+        for (const r of result.results) {
+            // 510(k)
+            if (r.k_number) {
+                lines.push(`### ${r.k_number}: ${r.device_name ?? 'Unknown device'}`);
+                lines.push(`**Applicant:** ${r.applicant ?? 'N/A'} | **Product code:** ${r.product_code ?? 'N/A'}`);
+                lines.push(`**Decision:** ${r.decision_description ?? 'N/A'} (${r.decision_date ?? 'N/A'})`);
+                if (r.advisory_committee_description)
+                    lines.push(`**Advisory committee:** ${r.advisory_committee_description}`);
+                if (r.clearance_type)
+                    lines.push(`**Clearance type:** ${r.clearance_type}`);
+                if (r.statement_or_summary) {
+                    const text = String(r.statement_or_summary);
+                    lines.push(`**Summary:** ${text.length > 500 ? `${text.slice(0, 500)}...` : text}`);
+                }
+            }
+            // PMA
+            else if (r.pma_number) {
+                const deviceLabel = r.trade_name ?? r.generic_name ?? '';
+                lines.push(`### ${r.pma_number}${deviceLabel ? `: ${deviceLabel}` : ''}`);
+                lines.push(`**Applicant:** ${r.applicant ?? 'N/A'} | **Product code:** ${r.product_code ?? 'N/A'}`);
+                lines.push(`**Decision:** ${r.decision_description ?? r.decision_code ?? 'N/A'} (${r.decision_date ?? 'N/A'})`);
+                if (r.advisory_committee_description)
+                    lines.push(`**Advisory committee:** ${r.advisory_committee_description}`);
+                if (r.supplement_number)
+                    lines.push(`**Supplement:** ${r.supplement_number}`);
+            }
+            // Fallback
+            else {
+                lines.push(`### Record`);
+                lines.push(`\`\`\`json\n${JSON.stringify(r, null, 2).slice(0, 500)}\n\`\`\``);
+            }
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-device-clearances.tool.js.map

package/dist/mcp-server/tools/definitions/search-device-clearances.tool.js.map

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

package/dist/mcp-server/tools/definitions/search-drug-approvals.tool.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Tool for searching FDA drug application approvals (NDAs and ANDAs)
+ * via the Drugs@FDA endpoint.
+ * @module mcp-server/tools/definitions/search-drug-approvals
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+/** Exported tool definition for searching drug approvals. */
+export declare const searchDrugApprovalsTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    search: z.ZodOptional<z.ZodString>;
+    sort: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    skip: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    meta: z.ZodObject<{
+        total: z.ZodNumber;
+        skip: z.ZodNumber;
+        limit: z.ZodNumber;
+        lastUpdated: z.ZodString;
+    }, z.core.$strip>;
+    results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+//# sourceMappingURL=search-drug-approvals.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-drug-approvals.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-drug-approvals.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-drug-approvals.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGjD,6DAA6D;AAC7D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;kBAoJlC,CAAC"}