get_dashboard_kpis

Returns pre-defined Key Performance Indicators (KPIs) for dashboards.

---

Description

A convenience tool that provides a curated set of KPIs in a single call. Returns aggregated metrics commonly used for operations dashboards and executive reporting.

---

Input Schema

{
  "type": "object",
  "properties": {},
  "required": []
}

No parameters required. This tool returns a fixed set of KPIs.

---

KPIs Returned

KPI	Description	Unit
Total Studies	Number of studies in the system	Count
Active Studies	Studies currently in progress	Count
Total Sites	Number of sites	Count
Active Sites	Sites currently active	Count
Total Subjects	All subjects enrolled	Count
Screen Failures	Subjects who failed screening	Count
Screen Failure Rate	Percentage of screen failures	%
Total Enrollments	Successful enrollments	Count
Enrollment Rate	Monthly enrollment velocity	/month
Adverse Events	Total adverse events reported	Count
Serious Adverse Events	SAEs requiring expedited reporting	Count
SAE Rate	SAEs per 100 subjects	%
Protocol Deviations	Total protocol deviations	Count
Query Rate	Data queries per subject	Avg
Data Entry Lag	Average days from visit to entry	Days

---

Example

Request

Prompt: "Show me the dashboard KPIs"

Tool call:

{}

Response

{
  "kpis": {
    "studies": {
      "total": 42,
      "active": 28,
      "completed": 12,
      "suspended": 2
    },
    "sites": {
      "total": 156,
      "active": 134,
      "enrolling": 98,
      "closed": 22
    },
    "subjects": {
      "total": 3450,
      "screened": 4200,
      "enrolled": 3450,
      "completed": 2100,
      "withdrawn": 320,
      "screenFailureRate": 17.86
    },
    "enrollment": {
      "thisMonth": 145,
      "lastMonth": 132,
      "monthOverMonthChange": 9.85,
      "averageMonthly": 138
    },
    "safety": {
      "totalAdverseEvents": 892,
      "seriousAdverseEvents": 45,
      "saeRate": 1.30,
      "deathsReported": 3
    },
    "quality": {
      "protocolDeviations": 234,
      "majorDeviations": 12,
      "dataQueries": 1560,
      "queryRate": 0.45,
      "averageDataEntryLag": 2.3
    },
    "generatedAt": "2024-01-15T10:30:00Z"
  }
}

---

Use Cases

Scenario	How KPIs Help
Executive Dashboard	Quick overview of operations health
Reporting	Standard metrics for stakeholder updates
Performance Tracking	Compare metrics over time
Monitoring	Track key trends
Reviews	Weekly/monthly operations meetings

---

Natural Language Examples

You Ask	Response
"What are our key metrics?"	Returns all KPIs
"Give me the dashboard numbers"	Returns all KPIs
"How are we performing?"	Returns all KPIs with analysis
"Show me the main KPIs"	Returns relevant subset
"Executive summary"	Returns KPIs formatted for executives

---

Integration Notes

Dashboard Integration

The KPIs returned are designed to populate standard operations dashboards:

┌─────────────────────────────────────────────────────────────┐
│  OPERATIONS DASHBOARD                                       │
├─────────────────┬─────────────────┬─────────────────────────┤
│  Studies: 42    │  Sites: 156     │  Subjects: 3,450        │
│  Active: 28     │  Active: 134    │  Enrolled: 3,450        │
├─────────────────┴─────────────────┴─────────────────────────┤
│  Enrollment This Month: 145 (+9.85%)                        │
├─────────────────────────────────────────────────────────────┤
│  SAE Rate: 1.30%    │    Query Rate: 0.45    │   Lag: 2.3d  │
└─────────────────────────────────────────────────────────────┘

Refresh Frequency

KPIs are calculated from real-time data. The generatedAt timestamp indicates when the metrics were computed.

---

Error Handling

Data Not Available

{
  "kpis": null,
  "error": "Unable to calculate KPIs: No data available"
}

Partial Data

If some metrics are unavailable, they will be returned as null:

{
  "kpis": {
    "studies": { "total": 42, "active": 28 },
    "safety": null,
    "error": "Safety data temporarily unavailable"
  }
}