BioContextAI Knowledgebase MCP

Instructions

Implementation Reference

• src/biocontext_kb/core/openfda/_get_drug_info.py:37-73 (handler)

  Handler function for the 'bc_get_drug_label_info' tool. It queries the FDA OpenFDA drug label API using brand name, generic name, or NDC code to retrieve comprehensive drug labeling information including active ingredients, indications, warnings, and dosage details.
  @core_mcp.tool() def get_drug_label_info( brand_name: Annotated[Optional[str], Field(description="Brand name of the drug")] = None, generic_name: Annotated[Optional[str], Field(description="Generic name of the drug")] = None, ndc: Annotated[Optional[str], Field(description="National Drug Code (NDC)")] = None, ) -> dict: """Get comprehensive drug labeling information from FDA. Includes active ingredients, dosage forms, administration routes. Returns: dict: Drug label results with indications, warnings, dosage, active ingredients or error message. """ if not any([brand_name, generic_name, ndc]): return {"error": "At least one of brand_name, generic_name, or ndc must be provided"} # Use the Drug Label API endpoint query_parts = [] if brand_name: query_parts.append(f"openfda.brand_name:{brand_name}") if generic_name: query_parts.append(f"openfda.generic_name:{generic_name}") if ndc: query_parts.append(f"openfda.package_ndc:{ndc}") query = " OR ".join(query_parts) if len(query_parts) > 1: query = f"({query})" base_url = "https://api.fda.gov/drug/label.json" params = {"search": query, "limit": 5} try: response = requests.get(base_url, params=params) # type: ignore response.raise_for_status() return response.json() except requests.exceptions.RequestException as e: return {"error": f"Failed to fetch FDA drug label data: {e!s}"}
• src/biocontext_kb/core/_server.py:3-7 (registration)

  The core_mcp FastMCP server instance named 'BC' where tools like 'bc_get_drug_label_info' are registered via decorators. The 'bc_' prefix comes from the server name.
  core_mcp = FastMCP( # type: ignore "BC", instructions="Provides access to biomedical knowledge bases.", )
• src/biocontext_kb/app.py:35-39 (registration)

  Imports the core_mcp server (containing the tool) into the main BioContextAI MCP app.
  for mcp in [core_mcp, *(await get_openapi_mcps())]: await mcp_app.import_server( mcp, slugify(mcp.name), )
• src/biocontext_kb/core/openfda/_get_drug_info.py:37-73 (schema)

  Input schema defined inline with Pydantic Field descriptions for the tool parameters.
  @core_mcp.tool() def get_drug_label_info( brand_name: Annotated[Optional[str], Field(description="Brand name of the drug")] = None, generic_name: Annotated[Optional[str], Field(description="Generic name of the drug")] = None, ndc: Annotated[Optional[str], Field(description="National Drug Code (NDC)")] = None, ) -> dict: """Get comprehensive drug labeling information from FDA. Includes active ingredients, dosage forms, administration routes. Returns: dict: Drug label results with indications, warnings, dosage, active ingredients or error message. """ if not any([brand_name, generic_name, ndc]): return {"error": "At least one of brand_name, generic_name, or ndc must be provided"} # Use the Drug Label API endpoint query_parts = [] if brand_name: query_parts.append(f"openfda.brand_name:{brand_name}") if generic_name: query_parts.append(f"openfda.generic_name:{generic_name}") if ndc: query_parts.append(f"openfda.package_ndc:{ndc}") query = " OR ".join(query_parts) if len(query_parts) > 1: query = f"({query})" base_url = "https://api.fda.gov/drug/label.json" params = {"search": query, "limit": 5} try: response = requests.get(base_url, params=params) # type: ignore response.raise_for_status() return response.json() except requests.exceptions.RequestException as e: return {"error": f"Failed to fetch FDA drug label data: {e!s}"}
• src/biocontext_kb/core/openfda/__init__.py:6-7 (helper)

  Imports the get_drug_label_info function into the openfda module namespace.
  from ._count_drugs import count_drugs_by_field, get_drug_statistics from ._get_drug_info import get_drug_by_application_number, get_drug_label_info