@cyanheads/openfda-mcp-server 0.1.6

package/README.md

@@ -0,0 +1,281 @@
+<div align="center">
+  <h1>@cyanheads/openfda-mcp-server</h1>
+  <p><b>Query FDA data on drugs, food, devices, and recalls via openFDA. STDIO or Streamable HTTP.</b>
+  <div>7 Tools</div>
+  </p>
+</div>
+
+<div align="center">
+
+[![npm](https://img.shields.io/npm/v/@cyanheads/openfda-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/openfda-mcp-server) [![Version](https://img.shields.io/badge/Version-0.1.6-blue.svg?style=flat-square)](./CHANGELOG.md) [![Framework](https://img.shields.io/badge/Built%20on-@cyanheads/mcp--ts--core-259?style=flat-square)](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) 
+
+[![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![TypeScript](https://img.shields.io/badge/TypeScript-^5.9.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.11-blueviolet.svg?style=flat-square)](https://bun.sh/)
+
+</div>
+
+---
+
+## Tools
+
+Seven tools for querying FDA data across drugs, food, devices, and recalls:
+
+| Tool | Description |
+|:---|:---|
+| `openfda_search_adverse_events` | Search adverse event reports across drugs, food, and devices |
+| `openfda_search_recalls` | Search enforcement reports and recall actions across drugs, food, and devices |
+| `openfda_count` | Aggregate and tally unique values for any field across any openFDA endpoint |
+| `openfda_get_drug_label` | Look up FDA drug labeling (package inserts / SPL documents) |
+| `openfda_search_drug_approvals` | Search the Drugs@FDA database for NDA/ANDA application approvals |
+| `openfda_search_device_clearances` | Search FDA device premarket notifications — 510(k) clearances and PMA approvals |
+| `openfda_lookup_ndc` | Look up drugs in the NDC (National Drug Code) Directory |
+
+### `openfda_search_adverse_events`
+
+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.
+
+- Category selection: `drug`, `food`, or `device` — each returns different field schemas
+- Elasticsearch query syntax for filtering by product, reaction, seriousness, date range
+- Pagination via `limit` (up to 1000) and `skip` (up to 25000)
+- Formatted output includes report ID, seriousness, patient demographics, reactions, and drugs with characterization
+
+---
+
+### `openfda_count`
+
+Aggregate and tally unique values for any field across any openFDA endpoint. Returns ranked term-count pairs sorted by count descending.
+
+- Works across all 19 openFDA endpoints (drugs, food, devices, animal/veterinary, other)
+- Use `.exact` suffix on field names for whole-phrase counting
+- Optional `search` filter to scope the aggregation
+- Returns up to 1000 terms per query
+
+---
+
+### `openfda_search_recalls`
+
+Search enforcement reports and recall actions across drugs, food, and devices.
+
+- Supports `enforcement` (all categories) and `recall` (devices only) endpoints
+- Filter by classification (Class I/II/III), recalling firm, reason, status
+- Formatted output includes recall number, classification, product description, reason, distribution pattern
+
+---
+
+### `openfda_search_device_clearances`
+
+Search FDA device premarket notifications — 510(k) clearances and PMA approvals.
+
+- Two pathways: `510k` (174K+ records, most common) and `pma` (higher-risk devices)
+- Filter by applicant, product code, advisory committee, device name
+- Formatted output adapts to pathway: 510(k) shows K-number/clearance type, PMA shows supplement info
+
+---
+
+### `openfda_get_drug_label`
+
+Look up FDA drug labeling (package inserts / SPL documents). Check indications, warnings, dosage, contraindications, active ingredients, or any structured label section.
+
+- Search by brand name, generic name, manufacturer, or set ID
+- Formatted output includes key label sections: boxed warning, indications, dosage, warnings, contraindications, adverse reactions, drug interactions, active ingredients
+- Large sections are automatically truncated to keep output readable
+- Default limit of 5 — labels are large documents
+
+---
+
+### `openfda_search_drug_approvals`
+
+Search the Drugs@FDA database for drug application approvals (NDAs and ANDAs). Returns application details, sponsor info, and full submission history.
+
+- Filter by brand name, sponsor, submission type, review priority
+- Formatted output includes products with active ingredients, dosage forms, routes, and marketing status
+- Full submission history with type, status, date, and review priority
+- Pagination via `limit` (up to 1000) and `skip` (up to 25000)
+
+---
+
+### `openfda_lookup_ndc`
+
+Look up drugs in the NDC (National Drug Code) Directory. Identify drug products by NDC code, find active ingredients, packaging details, or manufacturer info.
+
+- Search by product NDC, brand name, generic name, manufacturer, or active ingredient
+- Returns product details, active ingredients with strengths, and packaging information
+- Sortable by listing expiration date or other fields
+
+## Features
+
+Built on [`@cyanheads/mcp-ts-core`](https://www.npmjs.com/package/@cyanheads/mcp-ts-core):
+
+- Declarative tool definitions — single file per tool, framework handles registration and validation
+- Unified error handling across all tools
+- Pluggable auth (`none`, `jwt`, `oauth`)
+- Swappable storage backends: `in-memory`, `filesystem`, `Supabase`, `Cloudflare KV/R2/D1`
+- Structured logging with optional OpenTelemetry tracing
+- Runs locally (stdio/HTTP) or on Cloudflare Workers from the same codebase
+
+openFDA-specific:
+
+- Generic API client for all openFDA endpoints with retry (exponential backoff) and rate-limit awareness
+- Automatic error normalization — 404 returns empty results, 429/5xx retries, 400 provides actionable messages
+- Optional API key support — works without a key (1K requests/day), increases to 120K/day with a free key
+
+## Getting Started
+
+### Via bunx (no install)
+
+Add to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "openfda": {
+      "type": "stdio",
+      "command": "bunx",
+      "args": ["@cyanheads/openfda-mcp-server@latest"],
+      "env": {
+        "MCP_TRANSPORT_TYPE": "stdio",
+        "MCP_LOG_LEVEL": "info",
+        "OPENFDA_API_KEY": "your-key-here"
+      }
+    }
+  }
+}
+```
+
+Or with npx (no Bun required):
+
+```json
+{
+  "mcpServers": {
+    "openfda": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@cyanheads/openfda-mcp-server@latest"],
+      "env": {
+        "MCP_TRANSPORT_TYPE": "stdio",
+        "MCP_LOG_LEVEL": "info",
+        "OPENFDA_API_KEY": "your-key-here"
+      }
+    }
+  }
+}
+```
+
+Or with Docker:
+
+```json
+{
+  "mcpServers": {
+    "openfda": {
+      "type": "stdio",
+      "command": "docker",
+      "args": ["run", "-i", "--rm", "-e", "MCP_TRANSPORT_TYPE=stdio", "ghcr.io/cyanheads/openfda-mcp-server:latest"]
+    }
+  }
+}
+```
+
+For Streamable HTTP, set the transport and start the server:
+
+```sh
+MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 bun run start:http
+# Server listens at http://localhost:3010/mcp
+```
+
+### Prerequisites
+
+- [Bun v1.2.0](https://bun.sh/) or higher.
+- Optional: [openFDA API key](https://open.fda.gov/apis/authentication/) for higher rate limits (120K requests/day vs 1K/day).
+
+### Installation
+
+1. **Clone the repository:**
+
+```sh
+git clone https://github.com/cyanheads/openfda-mcp-server.git
+```
+
+2. **Navigate into the directory:**
+
+```sh
+cd openfda-mcp-server
+```
+
+3. **Install dependencies:**
+
+```sh
+bun install
+```
+
+## Configuration
+
+All configuration is validated at startup via Zod schemas in `src/config/server-config.ts`. Key environment variables:
+
+| Variable | Description | Default |
+|:---|:---|:---|
+| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http` | `stdio` |
+| `MCP_HTTP_PORT` | HTTP server port | `3010` |
+| `MCP_AUTH_MODE` | Authentication: `none`, `jwt`, or `oauth` | `none` |
+| `MCP_LOG_LEVEL` | Log level (`debug`, `info`, `warning`, `error`, etc.) | `info` |
+| `LOGS_DIR` | Directory for log files (Node.js only). | `<project-root>/logs` |
+| `STORAGE_PROVIDER_TYPE` | Storage backend: `in-memory`, `filesystem`, `supabase`, `cloudflare-kv/r2/d1` | `in-memory` |
+| `OPENFDA_API_KEY` | Free API key from [open.fda.gov](https://open.fda.gov/apis/authentication/). Increases daily limit from 1K to 120K requests. | none |
+| `OPENFDA_BASE_URL` | Base URL override for testing against a proxy or mock. | `https://api.fda.gov` |
+| `OTEL_ENABLED` | Enable OpenTelemetry | `false` |
+
+## Running the Server
+
+### Local Development
+
+- **Build and run the production version:**
+
+  ```sh
+  # One-time build
+  bun run rebuild
+
+  # Run the built server
+  bun run start:http
+  # or
+  bun run start:stdio
+  ```
+
+- **Dev mode with watch:**
+
+  ```sh
+  bun run dev:stdio     # or dev:http
+  ```
+
+- **Run checks and tests:**
+  ```sh
+  bun run devcheck  # Lints, formats, type-checks, and more
+  bun run test      # Runs the test suite
+  ```
+
+## Project Structure
+
+| Directory | Purpose |
+|:---|:---|
+| `src/index.ts` | Entry point — `createApp()` with tool registration and service setup. |
+| `src/config/` | Server-specific env var parsing and validation with Zod. |
+| `src/services/openfda/` | openFDA API client with retry, rate-limit handling, and error normalization. |
+| `src/mcp-server/tools/definitions/` | Tool definitions (`*.tool.ts`). Seven openFDA tools. |
+
+## Development Guide
+
+See [`CLAUDE.md`](./CLAUDE.md) for development guidelines and architectural rules. The short version:
+
+- Handlers throw, framework catches — no `try/catch` in tool logic
+- Use `ctx.log` for request-scoped logging
+- Register new tools in `src/mcp-server/tools/definitions/index.ts`
+
+## Contributing
+
+Issues and pull requests are welcome. Run checks and tests before submitting:
+
+```sh
+bun run devcheck
+bun run test
+```
+
+## License
+
+This project is licensed under the Apache 2.0 License. See the [LICENSE](./LICENSE) file for details.

package/dist/config/server-config.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview Server-specific configuration for the openFDA MCP server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+declare const ServerConfigSchema: z.ZodObject<{
+    apiKey: z.ZodOptional<z.ZodString>;
+    baseUrl: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type ServerConfig = z.infer<typeof ServerConfigSchema>;
+/** Lazy-parsed server config from environment variables. */
+export declare function getServerConfig(): ServerConfig;
+export {};
+//# sourceMappingURL=server-config.d.ts.map

package/dist/config/server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAE3C,QAAA,MAAM,kBAAkB;;;iBAMtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,4DAA4D;AAC5D,wBAAgB,eAAe,IAAI,YAAY,CAM9C"}

package/dist/config/server-config.js

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview Server-specific configuration for the openFDA MCP server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+const ServerConfigSchema = z.object({
+    apiKey: z
+        .string()
+        .optional()
+        .describe('openFDA API key — increases daily request limit from 1K to 120K'),
+    baseUrl: z.string().default('https://api.fda.gov').describe('openFDA API base URL'),
+});
+let _config;
+/** Lazy-parsed server config from environment variables. */
+export function getServerConfig() {
+    _config ??= ServerConfigSchema.parse({
+        apiKey: process.env.OPENFDA_API_KEY,
+        baseUrl: process.env.OPENFDA_BASE_URL,
+    });
+    return _config;
+}
+//# sourceMappingURL=server-config.js.map

package/dist/config/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAE3C,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,iEAAiE,CAAC;IAC9E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;CACpF,CAAC,CAAC;AAIH,IAAI,OAAiC,CAAC;AAEtC,4DAA4D;AAC5D,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,kBAAkB,CAAC,KAAK,CAAC;QACnC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe;QACnC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;KACtC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview openfda-mcp-server MCP server entry point.
+ * @module index
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview openfda-mcp-server MCP server entry point.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { allToolDefinitions } from './mcp-server/tools/definitions/index.js';
+import { initOpenFdaService } from './services/openfda/openfda-service.js';
+await createApp({
+    tools: allToolDefinitions,
+    setup() {
+        initOpenFdaService();
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE3E,MAAM,SAAS,CAAC;IACd,KAAK,EAAE,kBAAkB;IACzB,KAAK;QACH,kBAAkB,EAAE,CAAC;IACvB,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview MCP tool for openFDA count/aggregation queries. Tallies unique
+ * values for any field across any endpoint, returning ranked term-count pairs.
+ * @module mcp-server/tools/definitions/count.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const countTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    endpoint: z.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: z.ZodString;
+    search: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    meta: z.ZodObject<{
+        lastUpdated: z.ZodString;
+    }, z.core.$strip>;
+    results: z.ZodArray<z.ZodObject<{
+        term: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+//# sourceMappingURL=count.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"count.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/count.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AA0BjD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA+FpB,CAAC"}

package/dist/mcp-server/tools/definitions/count.tool.js

@@ -0,0 +1,106 @@
+/**
+ * @fileoverview MCP tool for openFDA count/aggregation queries. Tallies unique
+ * values for any field across any endpoint, returning ranked term-count pairs.
+ * @module mcp-server/tools/definitions/count.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getOpenFdaService } from '../../../services/openfda/openfda-service.js';
+/** All valid openFDA endpoint paths. */
+const ENDPOINTS = [
+    'drug/event',
+    'drug/label',
+    'drug/enforcement',
+    'drug/ndc',
+    'drug/drugsfda',
+    'drug/shortages',
+    'food/event',
+    'food/enforcement',
+    'device/event',
+    'device/510k',
+    'device/pma',
+    'device/recall',
+    'device/enforcement',
+    'device/classification',
+    'device/registrationlisting',
+    'device/udi',
+    'device/covid19serology',
+    'animalandveterinary/event',
+    'other/substance',
+];
+export const countTool = tool('openfda_count', {
+    description: 'Aggregate and tally unique values for any field across any openFDA endpoint. Returns ranked term-count pairs sorted by count descending.',
+    annotations: { readOnlyHint: true },
+    input: z.object({
+        endpoint: z
+            .enum(ENDPOINTS)
+            .describe('Full openFDA endpoint path (e.g. "drug/event", "device/classification")'),
+        count: z
+            .string()
+            .describe('Field to count. Append .exact for whole-phrase counting (e.g. "patient.reaction.reactionmeddrapt.exact", "openfda.brand_name.exact")'),
+        search: z
+            .string()
+            .optional()
+            .describe('Filter query to scope the count (e.g. patient.drug.medicinalproduct:"metformin")'),
+        limit: z
+            .number()
+            .min(1)
+            .max(1000)
+            .default(100)
+            .describe('Number of top terms to return (default 100, max 1000)'),
+    }),
+    output: z.object({
+        meta: z
+            .object({
+            lastUpdated: z.string().describe('Dataset last updated date'),
+        })
+            .describe('Response metadata'),
+        results: z
+            .array(z.object({
+            term: z.string().describe('Field value'),
+            count: z.number().describe('Number of occurrences'),
+        }))
+            .describe('Term-count pairs sorted by count descending'),
+        message: z.string().optional().describe('Guidance when results are empty'),
+    }),
+    async handler(input, ctx) {
+        const svc = getOpenFdaService();
+        const response = await svc.query(input.endpoint, {
+            search: input.search,
+            count: input.count,
+            limit: input.limit,
+        }, ctx);
+        ctx.log.info('Count query completed', {
+            endpoint: input.endpoint,
+            count: input.count,
+            terms: response.results.length,
+        });
+        const results = response.results.map((r) => ({
+            term: String(r.term),
+            count: r.count,
+        }));
+        if (results.length === 0) {
+            return {
+                meta: { lastUpdated: response.meta.lastUpdated },
+                results,
+                message: `No count results for ${input.count} on ${input.endpoint}${input.search ? ` with search: ${input.search}` : ''}. Verify the field name exists for this endpoint and check .exact suffix usage.`,
+            };
+        }
+        return { meta: { lastUpdated: response.meta.lastUpdated }, results };
+    },
+    format: (result) => {
+        if (result.results.length === 0) {
+            return [{ type: 'text', text: result.message ?? 'No count results.' }];
+        }
+        const totalCount = result.results.reduce((sum, r) => sum + r.count, 0);
+        const lines = [
+            `**${result.results.length} terms** (total occurrences: ${totalCount.toLocaleString()}) | Data updated: ${result.meta.lastUpdated}\n`,
+            '| # | Term | Count |',
+            '|---|------|-------|',
+        ];
+        for (const [i, r] of result.results.entries()) {
+            lines.push(`| ${i + 1} | ${r.term} | ${r.count.toLocaleString()} |`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=count.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/get-drug-label.tool.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Tool definition for looking up FDA drug labeling (package inserts / SPL documents).
+ * @module mcp-server/tools/definitions/get-drug-label
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const getDrugLabelTool: 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=get-drug-label.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-drug-label.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-drug-label.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-drug-label.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAKjD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;kBA6G3B,CAAC"}

package/dist/mcp-server/tools/definitions/get-drug-label.tool.js

@@ -0,0 +1,102 @@
+/**
+ * @fileoverview Tool definition for looking up FDA drug labeling (package inserts / SPL documents).
+ * @module mcp-server/tools/definitions/get-drug-label
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getOpenFdaService } from '../../../services/openfda/openfda-service.js';
+const ENDPOINT = 'drug/label';
+export const getDrugLabelTool = tool('openfda_get_drug_label', {
+    description: 'Look up FDA drug labeling (package inserts / SPL documents). Check indications, warnings, dosage, contraindications, active ingredients, or any structured label section.',
+    annotations: { readOnlyHint: true },
+    input: z.object({
+        search: z
+            .string()
+            .describe('Query targeting label fields. Examples: openfda.brand_name:"aspirin", openfda.generic_name:"metformin", openfda.manufacturer_name:"pfizer", set_id:"uuid".'),
+        sort: z.string().optional().describe('Sort order for results. Example: effective_time:desc.'),
+        limit: z
+            .number()
+            .min(1)
+            .max(1000)
+            .default(5)
+            .describe('Maximum number of results to return (1-1000). Default 5. Labels are large.'),
+        skip: z
+            .number()
+            .min(0)
+            .max(25000)
+            .default(0)
+            .describe('Number of results to skip for pagination (0-25000). Default 0.'),
+    }),
+    output: z.object({
+        meta: z
+            .object({
+            total: z.number().describe('Total matching results in the dataset.'),
+            skip: z.number().describe('Number of results skipped.'),
+            limit: z.number().describe('Maximum results returned per request.'),
+            lastUpdated: z.string().describe('Date the dataset was last updated.'),
+        })
+            .describe('Pagination and freshness metadata.'),
+        results: z.array(z.record(z.string(), z.any())).describe('Array of drug label records.'),
+        message: z.string().optional().describe('Human-readable note when the result set is empty.'),
+    }),
+    async handler(input, ctx) {
+        const service = getOpenFdaService();
+        const response = await service.query(ENDPOINT, {
+            search: input.search,
+            sort: input.sort,
+            limit: input.limit,
+            skip: input.skip,
+        }, ctx);
+        ctx.log.info('Drug label lookup completed', {
+            search: input.search,
+            total: response.meta.total,
+            returned: response.results.length,
+        });
+        return {
+            meta: response.meta,
+            results: response.results,
+            ...(response.results.length === 0 && {
+                message: `No labels matched${input.search ? ` search: ${input.search}` : ''}. Try broader terms or check field names (e.g. openfda.brand_name, openfda.generic_name, openfda.manufacturer_name).`,
+            }),
+        };
+    },
+    format: (result) => {
+        if (result.results.length === 0) {
+            return [{ type: 'text', text: result.message ?? 'No labels found.' }];
+        }
+        const lines = [
+            `**${result.meta.total.toLocaleString()} total labels** (showing ${result.results.length}, skip: ${result.meta.skip}) | Data updated: ${result.meta.lastUpdated}\n`,
+        ];
+        const sections = [
+            ['Boxed Warning', 'boxed_warning'],
+            ['Indications & Usage', 'indications_and_usage'],
+            ['Dosage & Administration', 'dosage_and_administration'],
+            ['Warnings', 'warnings'],
+            ['Contraindications', 'contraindications'],
+            ['Adverse Reactions', 'adverse_reactions'],
+            ['Drug Interactions', 'drug_interactions'],
+            ['Active Ingredient', 'active_ingredient'],
+        ];
+        for (const r of result.results) {
+            const openfda = r.openfda ?? {};
+            const brandName = (openfda.brand_name ?? [])[0] ?? 'Unknown';
+            const genericName = (openfda.generic_name ?? [])[0];
+            const manufacturer = (openfda.manufacturer_name ?? [])[0];
+            lines.push(`### ${brandName}${genericName ? ` (${genericName})` : ''}`);
+            if (manufacturer)
+                lines.push(`**Manufacturer:** ${manufacturer}`);
+            if (openfda.route)
+                lines.push(`**Route:** ${openfda.route.join(', ')}`);
+            for (const [label, key] of sections) {
+                const val = r[key];
+                if (!val)
+                    continue;
+                const text = Array.isArray(val) ? val.join('\n') : String(val);
+                const truncated = text.length > 1000 ? `${text.slice(0, 1000)}... (truncated)` : text;
+                lines.push(`\n**${label}:**\n${truncated}`);
+            }
+            lines.push('\n---\n');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-drug-label.tool.js.map

package/dist/mcp-server/tools/definitions/get-drug-label.tool.js.map

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