us-gov-open-data-mcp 1.0.0

package/dist/sdk/fda.d.ts

@@ -0,0 +1,356 @@
+/**
+ * FDA SDK — typed API client for the openFDA APIs.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { searchDrugEvents, searchFoodRecalls, countDrugEvents } from "us-gov-open-data/sdk/fda";
+ *
+ *   const events = await searchDrugEvents({ search: "patient.drug.openfda.brand_name:aspirin", limit: 5 });
+ *   console.log(events.meta.results.total, events.results);
+ *
+ *   const topReactions = await countDrugEvents("patient.reaction.reactionmeddrapt.exact");
+ *   console.log(topReactions.results); // [{term, count}, ...]
+ *
+ *   const recalls = await searchFoodRecalls({ search: "classification:\"Class I\"", limit: 10 });
+ *   console.log(recalls.results);
+ *
+ * No API key required (240 req/min without key, 120K req/day with key).
+ * Optional DATA_GOV_API_KEY for higher limits — get one at https://api.data.gov/signup/
+ * Docs: https://open.fda.gov/apis/
+ */
+export interface OpenFdaMeta {
+    disclaimer: string;
+    terms: string;
+    license: string;
+    last_updated: string;
+    results: {
+        skip: number;
+        limit: number;
+        total: number;
+    };
+}
+export interface DrugEvent {
+    safetyreportid: string;
+    receivedate: string;
+    receiptdate: string;
+    serious: string;
+    seriousnessdeath?: string;
+    seriousnesshospitalization?: string;
+    patient: {
+        patientonsetage?: string;
+        patientonsetageunit?: string;
+        patientsex?: string;
+        reaction: {
+            reactionmeddrapt: string;
+            reactionoutcome?: string;
+        }[];
+        drug: {
+            medicinalproduct: string;
+            drugindication?: string;
+            drugcharacterization?: string;
+            openfda?: {
+                brand_name?: string[];
+                generic_name?: string[];
+                manufacturer_name?: string[];
+                route?: string[];
+                substance_name?: string[];
+            };
+        }[];
+    };
+    [key: string]: unknown;
+}
+export interface DrugEventResult {
+    meta: OpenFdaMeta;
+    results: DrugEvent[];
+}
+export interface DrugLabel {
+    id: string;
+    effective_time?: string;
+    indications_and_usage?: string[];
+    warnings?: string[];
+    dosage_and_administration?: string[];
+    adverse_reactions?: string[];
+    drug_interactions?: string[];
+    description?: string[];
+    boxed_warning?: string[];
+    openfda: {
+        brand_name?: string[];
+        generic_name?: string[];
+        manufacturer_name?: string[];
+        route?: string[];
+        product_type?: string[];
+        substance_name?: string[];
+        rxcui?: string[];
+        unii?: string[];
+    };
+    [key: string]: unknown;
+}
+export interface DrugLabelResult {
+    meta: OpenFdaMeta;
+    results: DrugLabel[];
+}
+export interface FoodRecall {
+    report_date: string;
+    recall_number: string;
+    recall_initiation_date: string;
+    classification: string;
+    reason_for_recall: string;
+    status: string;
+    recalling_firm: string;
+    city: string;
+    state: string;
+    country: string;
+    product_description: string;
+    product_quantity: string;
+    distribution_pattern: string;
+    voluntary_mandated: string;
+    [key: string]: unknown;
+}
+export interface FoodRecallResult {
+    meta: OpenFdaMeta;
+    results: FoodRecall[];
+}
+export interface DeviceEvent {
+    event_key: string;
+    report_number: string;
+    date_received: string;
+    event_type: string;
+    device: {
+        brand_name: string;
+        generic_name: string;
+        manufacturer_d_name: string;
+        model_number?: string;
+        openfda?: {
+            device_name?: string;
+            medical_specialty_description?: string;
+            device_class?: string;
+        };
+    }[];
+    mdr_text?: {
+        text: string;
+        text_type_code: string;
+    }[];
+    [key: string]: unknown;
+}
+export interface DeviceEventResult {
+    meta: OpenFdaMeta;
+    results: DeviceEvent[];
+}
+export interface CountResult {
+    results: {
+        term: string;
+        count: number;
+    }[];
+}
+/**
+ * Search adverse drug events (FAERS).
+ *
+ * Example:
+ *   await searchDrugEvents({ search: "patient.drug.openfda.brand_name:aspirin", limit: 5 });
+ *   await searchDrugEvents({ search: "serious:1+AND+patient.patientsex:2", limit: 10 });
+ */
+export declare function searchDrugEvents(opts?: {
+    search?: string;
+    limit?: number;
+    skip?: number;
+}): Promise<DrugEventResult>;
+/**
+ * Search drug labels (package inserts / prescribing information).
+ *
+ * Example:
+ *   await searchDrugLabels({ search: "openfda.brand_name:tylenol", limit: 3 });
+ */
+export declare function searchDrugLabels(opts?: {
+    search?: string;
+    limit?: number;
+}): Promise<DrugLabelResult>;
+/**
+ * Search food recall enforcement reports.
+ *
+ * Example:
+ *   await searchFoodRecalls({ search: "classification:\"Class I\"", limit: 10 });
+ *   await searchFoodRecalls({ search: "recalling_firm:\"Trader Joe\"", limit: 5 });
+ */
+export declare function searchFoodRecalls(opts?: {
+    search?: string;
+    limit?: number;
+}): Promise<FoodRecallResult>;
+/**
+ * Search medical device adverse event reports (MAUDE).
+ *
+ * Example:
+ *   await searchDeviceEvents({ search: "device.generic_name:pacemaker", limit: 10 });
+ */
+export declare function searchDeviceEvents(opts?: {
+    search?: string;
+    limit?: number;
+}): Promise<DeviceEventResult>;
+/**
+ * Count/aggregate drug adverse events by a specific field.
+ * Returns top terms with counts, useful for finding most-reported reactions or drugs.
+ *
+ * Example:
+ *   // Top adverse reactions:
+ *   await countDrugEvents("patient.reaction.reactionmeddrapt.exact");
+ *
+ *   // Top reported drugs:
+ *   await countDrugEvents("patient.drug.openfda.brand_name.exact");
+ *
+ *   // Count by seriousness:
+ *   await countDrugEvents("serious");
+ */
+export declare function countDrugEvents(field: string, opts?: {
+    search?: string;
+    limit?: number;
+}): Promise<CountResult>;
+export interface DrugRecall {
+    report_date?: string;
+    recall_number?: string;
+    recall_initiation_date?: string;
+    classification?: string;
+    reason_for_recall?: string;
+    status?: string;
+    recalling_firm?: string;
+    city?: string;
+    state?: string;
+    product_description?: string;
+    product_quantity?: string;
+    distribution_pattern?: string;
+    openfda?: {
+        brand_name?: string[];
+        generic_name?: string[];
+        manufacturer_name?: string[];
+    };
+    [key: string]: unknown;
+}
+export interface DrugRecallResult {
+    meta: OpenFdaMeta;
+    results: DrugRecall[];
+}
+export interface ApprovedDrug {
+    application_number?: string;
+    sponsor_name?: string;
+    products?: Array<{
+        brand_name?: string;
+        active_ingredients?: Array<{
+            name: string;
+            strength: string;
+        }>;
+        route?: string;
+        dosage_form?: string;
+        marketing_status?: string;
+    }>;
+    submissions?: Array<{
+        submission_type?: string;
+        submission_number?: string;
+        submission_status?: string;
+        submission_status_date?: string;
+        application_docs?: Array<{
+            id: string;
+            url: string;
+            type: string;
+            title?: string;
+        }>;
+    }>;
+    openfda?: {
+        brand_name?: string[];
+        generic_name?: string[];
+        manufacturer_name?: string[];
+    };
+    [key: string]: unknown;
+}
+export interface ApprovedDrugResult {
+    meta: OpenFdaMeta;
+    results: ApprovedDrug[];
+}
+export interface FoodAdverseEvent {
+    report_number?: string;
+    date_created?: string;
+    date_started?: string;
+    outcomes?: string[];
+    products?: Array<{
+        name_brand?: string;
+        industry_name?: string;
+        role?: string;
+    }>;
+    reactions?: string[];
+    consumer?: {
+        age?: string;
+        age_unit?: string;
+        gender?: string;
+    };
+    [key: string]: unknown;
+}
+export interface FoodAdverseEventResult {
+    meta: OpenFdaMeta;
+    results: FoodAdverseEvent[];
+}
+export interface DeviceRecall {
+    res_event_number?: string;
+    firm_fei_number?: string;
+    k_numbers?: string[];
+    product_description?: string;
+    reason_for_recall?: string;
+    root_cause_description?: string;
+    event_date_terminated?: string;
+    openfda?: {
+        device_name?: string;
+        device_class?: string;
+        medical_specialty_description?: string;
+    };
+    [key: string]: unknown;
+}
+export interface DeviceRecallResult {
+    meta: OpenFdaMeta;
+    results: DeviceRecall[];
+}
+/**
+ * Search drug recall enforcement reports.
+ *
+ * Example:
+ *   await searchDrugRecalls({ search: 'classification:"Class I"', limit: 10 });
+ *   await searchDrugRecalls({ search: 'recalling_firm:"Pfizer"' });
+ */
+export declare function searchDrugRecalls(opts?: {
+    search?: string;
+    limit?: number;
+    skip?: number;
+}): Promise<DrugRecallResult>;
+/**
+ * Search FDA-approved drugs (Drugs@FDA database).
+ * Contains approval history, labeling, and active ingredients.
+ *
+ * Example:
+ *   await searchApprovedDrugs({ search: 'openfda.brand_name:"Ozempic"' });
+ *   await searchApprovedDrugs({ search: 'sponsor_name:"Pfizer"', limit: 10 });
+ */
+export declare function searchApprovedDrugs(opts?: {
+    search?: string;
+    limit?: number;
+    skip?: number;
+}): Promise<ApprovedDrugResult>;
+/**
+ * Search food adverse event reports (CAERS — FDA's food safety surveillance).
+ *
+ * Example:
+ *   await searchFoodAdverseEvents({ search: 'products.industry_name:"Dietary Supplements"' });
+ */
+export declare function searchFoodAdverseEvents(opts?: {
+    search?: string;
+    limit?: number;
+    skip?: number;
+}): Promise<FoodAdverseEventResult>;
+/**
+ * Search medical device recall reports.
+ *
+ * Example:
+ *   await searchDeviceRecalls({ search: 'openfda.device_name:"pacemaker"', limit: 10 });
+ */
+export declare function searchDeviceRecalls(opts?: {
+    search?: string;
+    limit?: number;
+    skip?: number;
+}): Promise<DeviceRecallResult>;
+/** Clear cached responses. */
+export declare function clearCache(): void;
+//# sourceMappingURL=fda.d.ts.map

package/dist/sdk/fda.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fda.d.ts","sourceRoot":"","sources":["../../src/sdk/fda.ts"],"names":[],"mappings":"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"}

package/dist/sdk/fda.js

@@ -0,0 +1,162 @@
+/**
+ * FDA SDK — typed API client for the openFDA APIs.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { searchDrugEvents, searchFoodRecalls, countDrugEvents } from "us-gov-open-data/sdk/fda";
+ *
+ *   const events = await searchDrugEvents({ search: "patient.drug.openfda.brand_name:aspirin", limit: 5 });
+ *   console.log(events.meta.results.total, events.results);
+ *
+ *   const topReactions = await countDrugEvents("patient.reaction.reactionmeddrapt.exact");
+ *   console.log(topReactions.results); // [{term, count}, ...]
+ *
+ *   const recalls = await searchFoodRecalls({ search: "classification:\"Class I\"", limit: 10 });
+ *   console.log(recalls.results);
+ *
+ * No API key required (240 req/min without key, 120K req/day with key).
+ * Optional DATA_GOV_API_KEY for higher limits — get one at https://api.data.gov/signup/
+ * Docs: https://open.fda.gov/apis/
+ */
+import { createClient } from "../client.js";
+// ─── Client ──────────────────────────────────────────────────────────
+const api = createClient({
+    baseUrl: "https://api.fda.gov",
+    name: "fda",
+    auth: { type: "query", key: "api_key", envVar: "DATA_GOV_API_KEY" },
+    rateLimit: { perSecond: 4, burst: 10 },
+    cacheTtlMs: 60 * 60 * 1000, // 1 hour
+});
+// ─── Public API ──────────────────────────────────────────────────────
+/**
+ * Search adverse drug events (FAERS).
+ *
+ * Example:
+ *   await searchDrugEvents({ search: "patient.drug.openfda.brand_name:aspirin", limit: 5 });
+ *   await searchDrugEvents({ search: "serious:1+AND+patient.patientsex:2", limit: 10 });
+ */
+export async function searchDrugEvents(opts = {}) {
+    return api.get("/drug/event.json", {
+        search: opts.search,
+        limit: opts.limit ?? 10,
+        skip: opts.skip,
+    });
+}
+/**
+ * Search drug labels (package inserts / prescribing information).
+ *
+ * Example:
+ *   await searchDrugLabels({ search: "openfda.brand_name:tylenol", limit: 3 });
+ */
+export async function searchDrugLabels(opts = {}) {
+    return api.get("/drug/label.json", {
+        search: opts.search,
+        limit: opts.limit ?? 10,
+    });
+}
+/**
+ * Search food recall enforcement reports.
+ *
+ * Example:
+ *   await searchFoodRecalls({ search: "classification:\"Class I\"", limit: 10 });
+ *   await searchFoodRecalls({ search: "recalling_firm:\"Trader Joe\"", limit: 5 });
+ */
+export async function searchFoodRecalls(opts = {}) {
+    return api.get("/food/enforcement.json", {
+        search: opts.search,
+        limit: opts.limit ?? 10,
+    });
+}
+/**
+ * Search medical device adverse event reports (MAUDE).
+ *
+ * Example:
+ *   await searchDeviceEvents({ search: "device.generic_name:pacemaker", limit: 10 });
+ */
+export async function searchDeviceEvents(opts = {}) {
+    return api.get("/device/event.json", {
+        search: opts.search,
+        limit: opts.limit ?? 10,
+    });
+}
+/**
+ * Count/aggregate drug adverse events by a specific field.
+ * Returns top terms with counts, useful for finding most-reported reactions or drugs.
+ *
+ * Example:
+ *   // Top adverse reactions:
+ *   await countDrugEvents("patient.reaction.reactionmeddrapt.exact");
+ *
+ *   // Top reported drugs:
+ *   await countDrugEvents("patient.drug.openfda.brand_name.exact");
+ *
+ *   // Count by seriousness:
+ *   await countDrugEvents("serious");
+ */
+export async function countDrugEvents(field, opts = {}) {
+    return api.get("/drug/event.json", {
+        search: opts.search,
+        count: field,
+        limit: opts.limit,
+    });
+}
+/**
+ * Search drug recall enforcement reports.
+ *
+ * Example:
+ *   await searchDrugRecalls({ search: 'classification:"Class I"', limit: 10 });
+ *   await searchDrugRecalls({ search: 'recalling_firm:"Pfizer"' });
+ */
+export async function searchDrugRecalls(opts = {}) {
+    return api.get("/drug/enforcement.json", {
+        search: opts.search,
+        limit: opts.limit ?? 10,
+        skip: opts.skip,
+    });
+}
+/**
+ * Search FDA-approved drugs (Drugs@FDA database).
+ * Contains approval history, labeling, and active ingredients.
+ *
+ * Example:
+ *   await searchApprovedDrugs({ search: 'openfda.brand_name:"Ozempic"' });
+ *   await searchApprovedDrugs({ search: 'sponsor_name:"Pfizer"', limit: 10 });
+ */
+export async function searchApprovedDrugs(opts = {}) {
+    return api.get("/drug/drugsfda.json", {
+        search: opts.search,
+        limit: opts.limit ?? 10,
+        skip: opts.skip,
+    });
+}
+/**
+ * Search food adverse event reports (CAERS — FDA's food safety surveillance).
+ *
+ * Example:
+ *   await searchFoodAdverseEvents({ search: 'products.industry_name:"Dietary Supplements"' });
+ */
+export async function searchFoodAdverseEvents(opts = {}) {
+    return api.get("/food/event.json", {
+        search: opts.search,
+        limit: opts.limit ?? 10,
+        skip: opts.skip,
+    });
+}
+/**
+ * Search medical device recall reports.
+ *
+ * Example:
+ *   await searchDeviceRecalls({ search: 'openfda.device_name:"pacemaker"', limit: 10 });
+ */
+export async function searchDeviceRecalls(opts = {}) {
+    return api.get("/device/recall.json", {
+        search: opts.search,
+        limit: opts.limit ?? 10,
+        skip: opts.skip,
+    });
+}
+/** Clear cached responses. */
+export function clearCache() {
+    api.clearCache();
+}
+//# sourceMappingURL=fda.js.map

package/dist/sdk/fda.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fda.js","sourceRoot":"","sources":["../../src/sdk/fda.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,wEAAwE;AAExE,MAAM,GAAG,GAAG,YAAY,CAAC;IACvB,OAAO,EAAE,qBAAqB;IAC9B,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE;IACnE,SAAS,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;IACtC,UAAU,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS;CACtC,CAAC,CAAC;AAiIH,wEAAwE;AAExE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAInC,EAAE;IACJ,OAAO,GAAG,CAAC,GAAG,CAAkB,kBAAkB,EAAE;QAClD,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAGnC,EAAE;IACJ,OAAO,GAAG,CAAC,GAAG,CAAkB,kBAAkB,EAAE;QAClD,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;KACxB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAGpC,EAAE;IACJ,OAAO,GAAG,CAAC,GAAG,CAAmB,wBAAwB,EAAE;QACzD,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;KACxB,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAGrC,EAAE;IACJ,OAAO,GAAG,CAAC,GAAG,CAAoB,oBAAoB,EAAE;QACtD,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;KACxB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAa,EAAE,OAGjD,EAAE;IACJ,OAAO,GAAG,CAAC,GAAG,CAAc,kBAAkB,EAAE;QAC9C,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC;AACL,CAAC;AAyED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAIpC,EAAE;IACJ,OAAO,GAAG,CAAC,GAAG,CAAmB,wBAAwB,EAAE;QACzD,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAItC,EAAE;IACJ,OAAO,GAAG,CAAC,GAAG,CAAqB,qBAAqB,EAAE;QACxD,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,OAI1C,EAAE;IACJ,OAAO,GAAG,CAAC,GAAG,CAAyB,kBAAkB,EAAE;QACzD,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAItC,EAAE;IACJ,OAAO,GAAG,CAAC,GAAG,CAAqB,qBAAqB,EAAE;QACxD,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC,CAAC;AACL,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,UAAU;IACxB,GAAG,CAAC,UAAU,EAAE,CAAC;AACnB,CAAC"}