search_spls
Search for FDA Structured Product Labels (SPLs) by drug name or using advanced parameters like NDC codes, RxNorm identifiers, and manufacturer details to retrieve comprehensive drug labeling information.
Instructions
Search for Structured Product Labels (SPLs) using either simple drug name search or advanced DailyMed API parameters. When using simple query, searches for drugs first then finds related SPLs. When using advanced parameters, queries DailyMed SPLs API directly. Supports pagination for large result sets.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Simple search query for drug name or active ingredient (use this OR advanced parameters, not both) | |
| application_number | No | NDA number (e.g., 'NDA012345') | |
| boxed_warning | No | Filter by presence of boxed warning | |
| dea_schedule_code | No | DEA schedule code (e.g., 'none', 'C48672') | |
| doctype | No | FDA document type | |
| drug_class_code | No | Pharmacologic drug class code | |
| drug_class_coding_system | No | Drug class coding system (default: '2.16.840.1.113883.3.26.1.5') | |
| drug_name | No | Generic or brand drug name for direct API search | |
| name_type | No | Name type filter | |
| labeler | No | Labeler name | |
| manufacturer | No | Manufacturer name | |
| marketing_category_code | No | FDA marketing category code | |
| ndc | No | National Drug Code | |
| published_date | No | Published date in YYYY-MM-DD format | |
| published_date_comparison | No | Date comparison operator | |
| rxcui | No | RxNorm Concept Unique Identifier | |
| setid | No | Label Set ID | |
| unii_code | No | Unique Ingredient Identifier | |
| page | No | Page number for pagination (1-based, default: 1) | |
| pageSize | No | Number of results per page (default: 25, max: 100 for advanced queries, max: 200 for simple queries) |
Implementation Reference
- src/clients/spl-client.ts:20-46 (handler)The main handler function for the `search_spls` tool. It delegates to either `searchSPLsByDrugName` or `searchSPLsAdvanced` based on the parameters provided.
async searchSPLs(params: AdvancedSPLSearchParams): Promise<PaginatedSPLResponse> { const { page = 1, pageSize = 25, query, ...advancedParams } = params; validatePaginationParams(page, pageSize); // Check if this is a simple query or advanced search const hasAdvancedParams = Object.values(advancedParams).some(value => value !== undefined); const isSimpleQuery = query && !hasAdvancedParams; if (!isSimpleQuery && !hasAdvancedParams) { throw new Error("Either 'query' or at least one advanced parameter is required"); } try { if (isSimpleQuery) { // Use the existing drug name search approach return await this.searchSPLsByDrugName(query!, page, pageSize); } else { // Use advanced DailyMed SPLs API search return await this.searchSPLsAdvanced(params); } } catch (error) { throw new Error( `Failed to search SPLs: ${error instanceof Error ? error.message : "Unknown error"}`, ); } } - src/tools.ts:218-222 (registration)Tool registration for `search_spls`. Defines the input schema and description.
{ name: "search_spls", description: "Search for Structured Product Labels (SPLs) using either simple drug name search or advanced DailyMed API parameters. When using simple query, searches for drugs first then finds related SPLs. When using advanced parameters, queries DailyMed SPLs API directly. Supports pagination for large result sets.", inputSchema: { type: "object",