bc_get_drug_statistics

Retrieve FDA drug database statistics including top sponsors, dosage forms, administration routes, and marketing statuses to analyze pharmaceutical data trends.

Instructions

Get general statistics about the FDA Drugs@FDA database. Includes top sponsors, dosage forms, routes, marketing status.

Returns: dict: Top sponsors, dosage_forms, administration_routes, marketing_statuses with counts or error message.

Input Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Implementation Reference

src/biocontext_kb/core/openfda/_count_drugs.py:56-91 (handler)

Handler function for the tool logic, decorated with @core_mcp.tool(). Fetches and aggregates drug statistics from the FDA Drugs@FDA API including top sponsors, dosage forms, administration routes, and marketing statuses.

@core_mcp.tool()
def get_drug_statistics() -> dict:
    """Get general statistics about the FDA Drugs@FDA database. Includes top sponsors, dosage forms, routes, marketing status.

    Returns:
        dict: Top sponsors, dosage_forms, administration_routes, marketing_statuses with counts or error message.
    """
    statistics = {}

    try:
        # Get top sponsors
        base_url = "https://api.fda.gov/drug/drugsfda.json"
        sponsors_response = requests.get(base_url, params={"count": "sponsor_name", "limit": 10})  # type: ignore
        sponsors_response.raise_for_status()
        statistics["top_sponsors"] = sponsors_response.json()

        # Get dosage forms
        dosage_response = requests.get(base_url, params={"count": "products.dosage_form", "limit": 15})  # type: ignore
        dosage_response.raise_for_status()
        statistics["dosage_forms"] = dosage_response.json()

        # Get routes of administration
        routes_response = requests.get(base_url, params={"count": "products.route", "limit": 15})  # type: ignore
        routes_response.raise_for_status()
        statistics["administration_routes"] = routes_response.json()

        # Get marketing statuses
        status_response = requests.get(base_url, params={"count": "products.marketing_status", "limit": 10})  # type: ignore
        status_response.raise_for_status()
        statistics["marketing_statuses"] = status_response.json()

        return statistics

    except requests.exceptions.RequestException as e:
        return {"error": f"Failed to fetch FDA drug statistics: {e!s}"}

src/biocontext_kb/app.py:34-38 (registration)
Registers the core_mcp server (containing the get_drug_statistics tool) into the main BioContextAI MCP application with the prefix 'bc' (from slugify('BC')), making the tool available as 'bc_get_drug_statistics'.
```
logger.info("Setting up MCP server...")
for mcp in [core_mcp, *(await get_openapi_mcps())]:
    await mcp_app.import_server(
        mcp,
        slugify(mcp.name),
```
src/biocontext_kb/core/__init__.py:13-13 (registration)
Imports the openfda module, triggering the registration of get_drug_statistics on core_mcp via its @core_mcp.tool() decorator when the module is loaded.
```
from .openfda import *
```
src/biocontext_kb/core/openfda/__init__.py:6-6 (registration)
Exposes the get_drug_statistics handler function for import, facilitating its registration.
```
from ._count_drugs import count_drugs_by_field, get_drug_statistics
```

BioContextAI Knowledgebase MCP