openfda-mcp-server 1.0.0

package/dist/types/fda.d.ts

@@ -0,0 +1,422 @@
+//#region src/types/fda.d.ts
+/**
+ * FDA API Types
+ * Type definitions for FDA OpenAPI responses
+ */
+type FDAResponse<T> = {
+  meta?: {
+    disclaimer?: string;
+    terms?: string;
+    license?: string;
+    last_updated?: string;
+    results?: {
+      skip: number;
+      limit: number;
+      total: number;
+    };
+  };
+  results?: T[];
+  error?: {
+    code: string;
+    message: string;
+  };
+};
+type OpenFDAFields = {
+  application_number?: string[];
+  brand_name?: string[];
+  generic_name?: string[];
+  manufacturer_name?: string[];
+  product_ndc?: string[];
+  product_type?: string[];
+  route?: string[];
+  substance_name?: string[];
+  rxcui?: string[];
+  spl_id?: string[];
+  spl_set_id?: string[];
+  pharm_class_epc?: string[];
+  pharm_class_cs?: string[];
+  pharm_class_pe?: string[];
+  pharm_class_moa?: string[];
+  nui?: string[];
+  unii?: string[];
+};
+type DrugAdverseEvent = {
+  safetyreportid?: string;
+  safetyreportversion?: string;
+  receivedate?: string;
+  receivedateformat?: string;
+  receiptdate?: string;
+  receiptdateformat?: string;
+  serious?: string;
+  seriousnesscongenitalanomali?: string;
+  seriousnessdeath?: string;
+  seriousnessdisabling?: string;
+  seriousnesshospitalization?: string;
+  seriousnesslifethreatening?: string;
+  seriousnessother?: string;
+  transmissiondate?: string;
+  transmissiondateformat?: string;
+  duplicate?: string;
+  companynumb?: string;
+  occurcountry?: string;
+  primarysourcecountry?: string;
+  primarysource?: {
+    qualification?: string;
+    reportercountry?: string;
+  };
+  reporttype?: string;
+  sender?: {
+    sendertype?: string;
+    senderorganization?: string;
+  };
+  receiver?: {
+    receivertype?: string;
+    receiverorganization?: string;
+  };
+  patient?: {
+    patientonsetage?: string;
+    patientonsetageunit?: string;
+    patientsex?: string;
+    patientweight?: string;
+    patientdeath?: {
+      patientdeathdate?: string;
+      patientdeathdateformat?: string;
+    };
+    drug?: Array<{
+      actiondrug?: string;
+      activesubstance?: {
+        activesubstancename?: string;
+      };
+      drugadditional?: string;
+      drugadministrationroute?: string;
+      drugauthorizationnumb?: string;
+      drugbatchnumb?: string;
+      drugcharacterization?: string;
+      drugcumulativedosagenumb?: string;
+      drugcumulativedosageunit?: string;
+      drugdosageform?: string;
+      drugdosagetext?: string;
+      drugenddate?: string;
+      drugenddateformat?: string;
+      drugindication?: string;
+      drugintervaldosagedefinition?: string;
+      drugintervaldosageunitnumb?: string;
+      drugrecurreadministration?: string;
+      drugseparatedosagenumb?: string;
+      drugstartdate?: string;
+      drugstartdateformat?: string;
+      drugstructuredosagenumb?: string;
+      drugstructuredosageunit?: string;
+      drugtreatmentduration?: string;
+      drugtreatmentdurationunit?: string;
+      medicinalproduct?: string;
+      openfda?: OpenFDAFields;
+    }>;
+    reaction?: Array<{
+      reactionmeddrapt?: string;
+      reactionmeddraversionpt?: string;
+      reactionoutcome?: string;
+    }>;
+  };
+};
+type DrugLabel = {
+  effective_time?: string;
+  id?: string;
+  set_id?: string;
+  version?: string;
+  spl_product_data_elements?: string[];
+  active_ingredient?: string[];
+  inactive_ingredient?: string[];
+  purpose?: string[];
+  indications_and_usage?: string[];
+  warnings?: string[];
+  do_not_use?: string[];
+  ask_doctor?: string[];
+  ask_doctor_or_pharmacist?: string[];
+  stop_use?: string[];
+  pregnancy_or_breast_feeding?: string[];
+  keep_out_of_reach_of_children?: string[];
+  dosage_and_administration?: string[];
+  storage_and_handling?: string[];
+  questions?: string[];
+  package_label_principal_display_panel?: string[];
+  description?: string[];
+  clinical_pharmacology?: string[];
+  mechanism_of_action?: string[];
+  pharmacodynamics?: string[];
+  pharmacokinetics?: string[];
+  contraindications?: string[];
+  warnings_and_cautions?: string[];
+  adverse_reactions?: string[];
+  drug_interactions?: string[];
+  use_in_specific_populations?: string[];
+  overdosage?: string[];
+  how_supplied?: string[];
+  information_for_patients?: string[];
+  clinical_studies?: string[];
+  openfda?: OpenFDAFields;
+};
+type DrugNDC = {
+  product_id?: string;
+  product_ndc?: string;
+  spl_id?: string;
+  product_type?: string;
+  finished?: string;
+  brand_name?: string;
+  brand_name_base?: string;
+  brand_name_suffix?: string;
+  generic_name?: string;
+  dosage_form?: string;
+  route?: string[];
+  marketing_start_date?: string;
+  marketing_end_date?: string;
+  marketing_category?: string;
+  application_number?: string;
+  labeler_name?: string;
+  active_ingredients?: Array<{
+    name?: string;
+    strength?: string;
+  }>;
+  packaging?: Array<{
+    package_ndc?: string;
+    description?: string;
+    marketing_start_date?: string;
+    marketing_end_date?: string;
+    sample?: string;
+  }>;
+  pharm_class?: string[];
+  openfda?: OpenFDAFields;
+};
+type DrugEnforcement = {
+  classification?: string;
+  center_classification_date?: string;
+  report_date?: string;
+  postal_code?: string;
+  termination_date?: string;
+  recall_initiation_date?: string;
+  recall_number?: string;
+  city?: string;
+  more_code_info?: string;
+  event_id?: string;
+  distribution_pattern?: string;
+  recalling_firm?: string;
+  voluntary_mandated?: string;
+  state?: string;
+  reason_for_recall?: string;
+  initial_firm_notification?: string;
+  status?: string;
+  product_type?: string;
+  country?: string;
+  product_description?: string;
+  code_info?: string;
+  address_1?: string;
+  address_2?: string;
+  product_quantity?: string;
+  openfda?: OpenFDAFields;
+};
+type DrugShortage = {
+  generic_name?: string;
+  proprietary_name?: string;
+  status?: string;
+  description?: string;
+  presentation?: string;
+  resolved_shortage_date?: string;
+  initial_posting_date?: string;
+};
+type DrugsFDA = {
+  application_number?: string;
+  sponsor_name?: string;
+  products?: Array<{
+    product_number?: string;
+    reference_drug?: string;
+    brand_name?: string;
+    active_ingredients?: Array<{
+      name?: string;
+      strength?: string;
+    }>;
+    reference_standard?: string;
+    dosage_form?: string;
+    route?: string;
+    marketing_status?: string;
+  }>;
+  submissions?: Array<{
+    submission_type?: string;
+    submission_number?: string;
+    submission_status?: string;
+    submission_status_date?: string;
+    review_priority?: string;
+    submission_class_code?: string;
+    submission_class_code_description?: string;
+    application_docs?: Array<{
+      id?: string;
+      url?: string;
+      date?: string;
+      type?: string;
+    }>;
+  }>;
+  openfda?: OpenFDAFields;
+};
+type Device510K = {
+  k_number?: string;
+  applicant?: string;
+  contact?: string;
+  address_1?: string;
+  address_2?: string;
+  city?: string;
+  state?: string;
+  zip_code?: string;
+  country_code?: string;
+  postal_code?: string;
+  date_received?: string;
+  decision_date?: string;
+  decision_code?: string;
+  decision_description?: string;
+  product_code?: string;
+  statement_or_summary?: string;
+  clearance_type?: string;
+  third_party_flag?: string;
+  expedited_review_flag?: string;
+  device_name?: string;
+  openfda?: {
+    device_name?: string;
+    device_class?: string;
+    medical_specialty_description?: string;
+    regulation_number?: string;
+    fei_number?: string[];
+  };
+};
+type DeviceClassification = {
+  device_name?: string;
+  device_class?: string;
+  definition?: string;
+  gmp_exempt_flag?: string;
+  implant_flag?: string;
+  life_sustain_support_flag?: string;
+  medical_specialty?: string;
+  medical_specialty_description?: string;
+  product_code?: string;
+  regulation_number?: string;
+  review_code?: string;
+  review_panel?: string;
+  submission_type_id?: string;
+  third_party_flag?: string;
+  unclassified_reason?: string;
+  openfda?: {
+    fei_number?: string[];
+    k_number?: string[];
+    pma_number?: string[];
+    registration_number?: string[];
+  };
+};
+type DeviceAdverseEvent = {
+  adverse_event_flag?: string;
+  product_problem_flag?: string;
+  date_of_event?: string;
+  date_report?: string;
+  date_received?: string;
+  date_facility_aware?: string;
+  report_number?: string;
+  report_source_code?: string;
+  health_professional?: string;
+  reporter_occupation_code?: string;
+  initial_report_to_fda?: string;
+  reprocessed_and_reused_flag?: string;
+  manufacturer_name?: string;
+  manufacturer_address_1?: string;
+  manufacturer_city?: string;
+  manufacturer_state?: string;
+  manufacturer_zip_code?: string;
+  manufacturer_country?: string;
+  event_type?: string;
+  type_of_report?: string[];
+  device?: Array<{
+    brand_name?: string;
+    generic_name?: string;
+    manufacturer_d_name?: string;
+    manufacturer_d_address_1?: string;
+    manufacturer_d_city?: string;
+    manufacturer_d_state?: string;
+    manufacturer_d_zip_code?: string;
+    manufacturer_d_country?: string;
+    device_operator?: string;
+    model_number?: string;
+    catalog_number?: string;
+    lot_number?: string;
+    other_id_number?: string;
+    device_availability?: string;
+    device_evaluated_by_manufacturer?: string;
+    device_report_product_code?: string;
+    openfda?: {
+      device_name?: string;
+      device_class?: string;
+      medical_specialty_description?: string;
+      regulation_number?: string;
+    };
+  }>;
+  patient?: Array<{
+    patient_sequence_number?: string;
+    date_received?: string;
+    sequence_number_treatment?: string;
+    sequence_number_outcome?: string[];
+  }>;
+  mdr_text?: Array<{
+    mdr_text_key?: string;
+    text_type_code?: string;
+    patient_sequence_number?: string;
+    text?: string;
+  }>;
+};
+type DeviceEnforcement = {
+  classification?: string;
+  center_classification_date?: string;
+  report_date?: string;
+  postal_code?: string;
+  termination_date?: string;
+  recall_initiation_date?: string;
+  recall_number?: string;
+  city?: string;
+  event_id?: string;
+  distribution_pattern?: string;
+  recalling_firm?: string;
+  voluntary_mandated?: string;
+  state?: string;
+  reason_for_recall?: string;
+  initial_firm_notification?: string;
+  status?: string;
+  product_type?: string;
+  country?: string;
+  product_description?: string;
+  code_info?: string;
+  product_quantity?: string;
+  openfda?: {
+    device_name?: string;
+    device_class?: string;
+    medical_specialty_description?: string;
+    regulation_number?: string;
+    k_number?: string[];
+    pma_number?: string[];
+    fei_number?: string[];
+    registration_number?: string[];
+  };
+};
+type SearchParams = {
+  search?: string;
+  count?: string;
+  limit?: number;
+  skip?: number;
+};
+type FDAToolResponse<T> = {
+  success: boolean;
+  data?: T;
+  error?: string;
+  searchParams?: SearchParams;
+  totalResults?: number;
+  displayedResults?: number;
+  apiUsage?: {
+    authenticated: boolean;
+    rateLimit: string;
+  };
+};
+//#endregion
+export { Device510K, DeviceAdverseEvent, DeviceClassification, DeviceEnforcement, DrugAdverseEvent, DrugEnforcement, DrugLabel, DrugNDC, DrugShortage, DrugsFDA, FDAResponse, FDAToolResponse, OpenFDAFields, SearchParams };
+//# sourceMappingURL=fda.d.ts.map

package/dist/types/fda.js

@@ -0,0 +1 @@
+export{};

package/dist/utils/api-client.d.ts

@@ -0,0 +1,38 @@
+import { Device510K, DeviceAdverseEvent, DeviceClassification, DeviceEnforcement, DrugAdverseEvent, DrugEnforcement, DrugLabel, DrugNDC, DrugShortage, DrugsFDA, FDAResponse, SearchParams } from "../types/fda.js";
+
+//#region src/utils/api-client.d.ts
+
+declare class FDAAPIClient {
+  private apiKey;
+  private baseUrl;
+  constructor();
+  /**
+   * Build URL search parameters for the FDA API
+   */
+  private buildSearchParams;
+  /**
+   * Make a request to an FDA API endpoint
+   */
+  private request;
+  /**
+   * Get rate limit info based on authentication status
+   */
+  getRateLimitInfo(): {
+    authenticated: boolean;
+    rateLimit: string;
+  };
+  searchDrugAdverseEvents(params: SearchParams): Promise<FDAResponse<DrugAdverseEvent>>;
+  searchDrugLabels(params: SearchParams): Promise<FDAResponse<DrugLabel>>;
+  searchDrugNDC(params: SearchParams): Promise<FDAResponse<DrugNDC>>;
+  searchDrugEnforcement(params: SearchParams): Promise<FDAResponse<DrugEnforcement>>;
+  searchDrugsFDA(params: SearchParams): Promise<FDAResponse<DrugsFDA>>;
+  searchDrugShortages(params: SearchParams): Promise<FDAResponse<DrugShortage>>;
+  searchDevice510K(params: SearchParams): Promise<FDAResponse<Device510K>>;
+  searchDeviceClassifications(params: SearchParams): Promise<FDAResponse<DeviceClassification>>;
+  searchDeviceAdverseEvents(params: SearchParams): Promise<FDAResponse<DeviceAdverseEvent>>;
+  searchDeviceEnforcement(params: SearchParams): Promise<FDAResponse<DeviceEnforcement>>;
+}
+declare const fdaAPIClient: FDAAPIClient;
+//#endregion
+export { FDAAPIClient, fdaAPIClient };
+//# sourceMappingURL=api-client.d.ts.map

package/dist/utils/api-client.js

@@ -0,0 +1 @@
+import"./logger.js";import{n as e,t}from"../api-client-BGnUXMwX.js";export{t as FDAAPIClient,e as fdaAPIClient};

package/dist/utils/logger.d.ts

@@ -0,0 +1,14 @@
+import debug from "debug";
+
+//#region src/utils/logger.d.ts
+
+declare const loggers: {
+  core: debug.Debugger;
+  api: debug.Debugger;
+  tools: debug.Debugger;
+  main: debug.Debugger;
+  fastmcp: debug.Debugger;
+};
+//#endregion
+export { loggers };
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.js

@@ -0,0 +1,2 @@
+import e from"debug";const t={core:e(`openfda-mcp:core`),api:e(`openfda-mcp:api`),tools:e(`openfda-mcp:tools`),main:e(`openfda-mcp:main`),fastmcp:e(`openfda-mcp:fastmcp`)};export{t as loggers};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","names":[],"sources":["../../src/utils/logger.ts"],"sourcesContent":["/**\n * Logger utility for OpenFDA MCP Server\n * Uses debug module for namespace-based logging\n *\n * Enable with: DEBUG=openfda-mcp:* <command>\n */\n\nimport debug from \"debug\"\n\nexport const loggers = {\n  core: debug(\"openfda-mcp:core\"),\n  api: debug(\"openfda-mcp:api\"),\n  tools: debug(\"openfda-mcp:tools\"),\n  main: debug(\"openfda-mcp:main\"),\n  fastmcp: debug(\"openfda-mcp:fastmcp\"),\n}\n"],"mappings":"qBASA,MAAa,EAAU,CACrB,KAAM,EAAM,mBAAmB,CAC/B,IAAK,EAAM,kBAAkB,CAC7B,MAAO,EAAM,oBAAoB,CACjC,KAAM,EAAM,mBAAmB,CAC/B,QAAS,EAAM,sBAAsB,CACtC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "openfda-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for querying U.S. FDA public datasets - drugs, devices, adverse events, recalls, and more",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "fda",
+    "openfda",
+    "drugs",
+    "medical-devices",
+    "typescript"
+  ],
+  "author": "jordan.burke@gmail.com",
+  "license": "MIT",
+  "homepage": "https://github.com/jordanburke/openfda-mcp-server",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jordanburke/openfda-mcp-server"
+  },
+  "dependencies": {
+    "@jordanburke/fastmcp": "^3.26.700",
+    "commander": "^14.0.2",
+    "debug": "^4.4.3",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/debug": "^4.1.12",
+    "@types/node": "^24.10.4",
+    "ts-builds": "^2.1.0",
+    "tsdown": "^0.18.4",
+    "tsx": "^4.21.0"
+  },
+  "type": "module",
+  "bin": {
+    "openfda-mcp-server": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./lib": {
+      "types": "./dist/lib.d.ts",
+      "import": "./dist/lib.js"
+    }
+  },
+  "files": [
+    "lib",
+    "dist"
+  ],
+  "prettier": "ts-builds/prettier",
+  "scripts": {
+    "validate": "ts-builds validate",
+    "format": "ts-builds format",
+    "format:check": "ts-builds format:check",
+    "lint": "ts-builds lint",
+    "lint:check": "ts-builds lint:check",
+    "typecheck": "ts-builds typecheck",
+    "test": "ts-builds test",
+    "test:watch": "ts-builds test:watch",
+    "test:coverage": "ts-builds test:coverage",
+    "build": "ts-builds build",
+    "dev": "ts-builds dev",
+    "serve:test": "tsx src/index.ts",
+    "serve:test:http": "tsx src/index.ts --transport http"
+  }
+}