MedRecPro MCP Server

search_drug_labels ──► Quick lookups, section queries, comparisons
                       ├── ProductName, ActiveIngredient, UNII
                       ├── Label sections (Indications, Warnings, etc.)
                       └── ViewLabelUrl - link to FDA label

export_drug_label_markdown ──► Complete label export (TWO-STEP)
  Step 1: Search products ─────► User selects DocumentGUID
  Step 2: Export markdown ──────► FullMarkdown + ViewLabelUrl

search_expiring_patents ──► Orange Book patent searches
                            ├── Patent expiration dates
                            └── Generic availability timeline

search_by_pharmacologic_class ──► Drug class discovery
                                  ├── AI-powered class matching
                                  └── Products grouped by class

search_by_indication ──► Condition-based drug discovery
                         ├── AI-powered indication matching
                         └── Products grouped by indication

search_drug_labels

Searches for FDA drug labels and returns complete product details with markdown-formatted label sections.

Use when the user asks specific questions about a drug (e.g., "What are the side effects of Lipitor?" or "Compare aspirin and ibuprofen").

Parameter	Type	Required	Description
productNameSearch	string	Optional	Brand/product name search (e.g., "Lipitor", "Advil"). Supports partial matching.
activeIngredientSearch	string	Optional	Generic/active ingredient name search (e.g., "atorvastatin", "ibuprofen"). Supports partial matching.
unii	string	Optional	UNII (Unique Ingredient Identifier) code for exact chemical match (e.g., "R16CO5Y76E" for aspirin).
sectionCode	string	Optional	LOINC section code to filter results to a specific label section. See section codes table below.
pageNumber	int	Optional	Page number for pagination (1-based). Default: 1.
pageSize	int	Optional	Results per page (1–50). Default: 10. Recommended: 3 for initial searches since labels are large.

Returns: Array of product objects containing ProductName, ActiveIngredient, UNII, DocumentGUID, markdown-formatted label Sections, and a ViewLabelUrl link to view the FDA label in a browser.

export_drug_label_markdown

Exports a complete FDA drug label as clean, well-formatted markdown.

Use when the user wants a complete label (e.g., "Show me the full label for Lipitor" or "Export the label for atorvastatin").

Step 1 — Product Search: Call without documentGuid to search for products.

Parameter	Type	Required	Description
productNameSearch	string	Optional	Brand/product name search (e.g., "Lipitor").
activeIngredientSearch	string	Optional	Generic ingredient name search (e.g., "atorvastatin").
unii	string	Optional	UNII code for exact ingredient match.

List of matching products with ProductName, ActiveIngredient, UNII, and DocumentGUID. The user selects the correct product.

Step 2 — Export Markdown: Call with documentGuid from Step 1 selection.

Parameter	Type	Required	Description
documentGuid	string	Required	DocumentGUID from Step 1 selection (e.g., "052493C7-89A3-452E-8140-04DD95F0D9E2").

Complete label as formatted markdown with source links (ViewLabelUrl).

search_expiring_patents

Searches Orange Book NDA patents by expiration date, brand name, or active ingredient.

Use when the user asks about patent expiration or generic drug availability (e.g., "When will generic Ozempic be available?" or "What patents expire in 6 months?").

Parameter	Type	Required	Description
tradeName	string	Optional	Brand name search (e.g., "Ozempic", "Lipitor"). Supports partial matching.
ingredient	string	Optional	Generic/active ingredient name search (e.g., "semaglutide", "atorvastatin").
expiringInMonths	int	Optional	Patent expiration window in months (e.g., 6 for next 6 months). Must be > 0.
pageNumber	int	Optional	Page number (1-based). Default: 1.
pageSize	int	Optional	Results per page (1–200). Default: 10.

Returns: Patents with trade name, active ingredient, expiry date, patent number, and dosage form. Includes pre-rendered markdown table and links to FDA labels when available.

search_by_pharmacologic_class

Discovers groups of drugs by therapeutic or pharmacologic class using AI-powered natural language search.

Use when the user asks about drug classes or groups (e.g., "Show me all beta blockers" or "What SSRIs are available?").

Parameter	Type	Required	Description
query	string	Optional	AI-powered natural language search (e.g., "beta blockers", "SSRIs", "statins"). Maps common terms to pharmacologic classes.
classNameSearch	string	Optional	Direct partial match on exact class names (fallback if AI search returns no results).
maxProductsPerClass	int	Optional	Maximum products per class (1–1000). Default: 500.
pageNumber	int	Optional	Page number (1-based, used with classNameSearch). Default: 1.
pageSize	int	Optional	Results per page (1–200, used with classNameSearch). Default: 25.

Returns: Matched classes, products grouped by class with label links, total product count, and suggested follow-up queries.

search_by_indication

Discovers drugs that treat a specific medical condition or disease using AI-powered matching.

Use when the user asks what drugs treat a condition (e.g., "What drugs treat high blood pressure?" or "What medications are used for diabetes?").

Parameter	Type	Required	Description
query	string	Required	Natural language condition search (e.g., "high blood pressure", "diabetes", "depression"). AI maps common terms to medical conditions.
maxProductsPerIndication	int	Optional	Maximum products per indication (1–100). Default: 25.

Returns: Matched indications, products grouped by indication with label links, total product count, validation reason, and suggested follow-up queries.

get_my_profile

Gets the current authenticated user's profile information including name, email, and roles.

No parameters required.

get_my_activity

Gets the current user's recent activity log showing actions performed in the system.

Parameter	Type	Required	Description
pageNumber	int	Optional	Page number (1-based). Default: 1.
pageSize	int	Optional	Results per page (1–100). Default: 20.

get_my_activity_by_date_range

Gets the current user's activity within a specific date range.

Parameter	Type	Required	Description
startDate	string	Required	Start date in ISO 8601 format (e.g., 2024-01-01).
endDate	string	Required	End date in ISO 8601 format (e.g., 2024-12-31).
pageNumber	int	Optional	Page number (1-based). Default: 1.
pageSize	int	Optional	Results per page (1–100). Default: 20.