Skip to main content
Glama
health-product-shortages-canada

health-product-shortages-canada

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
HPSC_EMAILYesEmail address for your free Health Product Shortages Canada account.
HPSC_BASE_URLNoOverride the Health Product Shortages Canada API base URL.https://healthproductshortages.ca/api/v1
HPSC_PASSWORDYesPassword for your Health Product Shortages Canada account.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_shortagesB

Search Canadian drug shortage and discontinuation reports.

Args: query: Brand name, ingredient, company or ATC text (e.g. "amoxicillin"). din: 8-digit Drug Identification Number, if known. status: One of resolved, anticipated_shortage, active_confirmed, avoided_shortage, discontinued. Leave empty for all. limit: Max reports to return (1-100). offset: For paging through results.

get_reportB

Get the full detail of one report.

Args: report_id: The report number shown on healthproductshortages.ca. report_type: "shortage" or "discontinuation".

check_watchlistA

Check a list of drugs (DINs or names) for current shortages or discontinuations.

Use this for a pharmacy formulary, a clinic's top drugs, or a patient's med list.

Args: items: DINs (8 digits) and/or drug names, up to 50. include_anticipated: Also flag anticipated shortages, not just actual ones.

list_tier3A

List current Tier 3 (highest-impact) shortages.

The API has no Tier 3 filter, so this pages through active and anticipated reports (100 per page, sorted by report ID ascending, as the API docs require for multi-report extraction) and keeps the Tier 3 ones.

Args: query: Optional text to narrow the scan (a drug, ingredient or company). max_pages: Safety cap on pages of 100 per status (1-50). Results are cached for 10 minutes, so repeat calls are cheap. include_discontinued: Also scan discontinued reports (a long, mostly historical list).

data_quality_scanA

Scan ALL open shortage reports and return summary data-quality numbers (no report list): how many are past their estimated end date, not updated in a long time, duplicated for the same DIN, or mention partial supply, plus the companies with the most overdue reports.

Uses about 1 API request per 100 reports (sorted by ID ascending, as the API docs require). Results are cached for 10 minutes.

Args: max_pages: Safety cap on pages of 100 per status (1-200). include_anticipated: Include anticipated shortages as well as actual ones. top_n: How many companies and examples to list.

build_dashboardB

Build the Canadian Drug Shortage Monitor dashboard (a single HTML file) from today's live data and save it on this computer.

Args: output_dir: Folder to write into. Default: Documents/hpsc-dashboard in the user's home. author: Name shown in the credits (optional). author_url: Link for the author name, e.g. a LinkedIn profile (optional). repo_url: GitHub repository link shown in the footer (optional).

recent_updatesA

Most recently updated reports, newest first. Good for a daily digest.

Args: status: resolved, anticipated_shortage, active_confirmed, avoided_shortage or discontinued. limit: 1-100.

lookup_drugB

Look up a drug in Health Canada's Drug Product Database (no account needed).

Returns ingredients, strength, form, route, ATC class and marketing status.

find_alternativesA

Find other marketed Canadian products with the SAME active ingredient(s), form and route as a DIN, and check whether each one is also in shortage.

This is a same-ingredient (generic/brand interchange) search, not a therapeutic substitution recommendation.

Args: din: DIN of the product that is short. max_candidates: Cap on alternative products to examine (1-40). check_shortages: Also check each alternative against HPSC.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.7/5.0

Scored across 9 tools

Disambiguation4/5

Most tools have clearly distinct purposes: search_shortages, check_watchlist, recent_updates, and list_tier3 all return reports but are differentiated by input style (query vs. batch list), ordering (newest-first), and a specific impact filter. There is mild residual overlap between search_shortages and check_watchlist for checking a single drug, and list_tier3 partially duplicates what a status-filtered search could do, but the descriptions make the intended use cases clear. lookup_drug, find_alternatives, data_quality_scan, and build_dashboard occupy clearly separate niches.

Naming Consistency4/5

Seven of nine names follow a consistent snake_case verb_noun pattern (search_shortages, get_report, check_watchlist, list_tier3, build_dashboard, lookup_drug, find_alternatives). The exceptions, recent_updates and data_quality_scan, are noun phrases rather than verb-led, which is a minor deviation but still readable and predictable within the set.

Tool Count5/5

Nine tools is a well-scoped surface for a drug shortage monitoring server: a core search/detail pair, three specialized listing views, quality analytics, a drug reference lookup, an alternatives finder, and one export tool. Each tool maps to a distinct user workflow and none feel like padding.

Completeness4/5

The surface covers the lifecycle well: find reports, inspect a report, batch-check a med list, surface recent changes, isolate high-impact shortages, analyze data quality, look up drug identity, and find same-ingredient alternatives plus an export. Minor gaps remain — no company/ATC-level aggregation view, no way to fetch shortage history or trends over time for a specific drug, and no generalized bulk export beyond the fixed dashboard format — but agents can work around these with search filters.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues