health-product-shortages-canada
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@health-product-shortages-canada Is amoxicillin 500 mg in shortage right now?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Canadian Drug Shortage Monitor
Open tools that make Canada's official drug shortage data easier to use and easier to trust.
A public dashboard, rebuilt every day: what's short right now, with duplicate reports merged and a report-freshness label on every report. Live site: https://utsavamehta-cloud.github.io/canada-drug-shortage-monitor/
A Claude MCP server, so pharmacists, analysts and developers can ask about shortages in plain language from Claude.
Why
Drug companies in Canada must report every shortage to Health Canada's reporting site, Health Product Shortages Canada. The data is valuable, but much of it goes stale. A full scan of all 1,742 open reports on 12 November 2026 found:
51% not updated in over a year
61% with no estimated end date
10% duplicates (158 products with 2 to 4 open reports each)
106 reports past their own estimated end date, 71 of them by more than a year
An old report is not necessarily wrong, since some shortages really do last a long time. But pharmacists can't tell from the report alone, so they double-check by phone. This project labels every report with plain date facts (when it was last updated, whether its end date has passed) so you can see at a glance which ones to confirm with your supplier.
Information only, from manufacturer reports to Health Canada. Not medical advice. Independent project, not affiliated with Health Canada or the operator of the reporting site.
Related MCP server: rx-shortage-mcp
The dashboard
Two views plus a method page:
View | For | What it shows |
What's short now | Pharmacists, clinics, long-term care | Every product with an open report (merged by DIN), Tier 3 first, with search and filters by status, report freshness and therapeutic group, plus what changed in the last 7 days |
Report freshness | Health Canada, provinces, associations, researchers | Time since each open report was last updated, by therapeutic group and by company, with a daily trend line |
Report freshness labels. Each one states a date fact from the report itself, never a judgement:
Label | Rule (checked in this order) |
Past estimated end date | Report still open, but the end date the company gave has passed |
No update in 12+ months | Report still open and not changed in over a year |
No end date given | No estimated end date |
Updated in last 14 days | Changed in the last 14 days |
End date still ahead | Everything else: the end date is in the future |
The first two are flagged check_with_supplier. They are prompts to confirm, not findings of fault.
Build it yourself:
pip install .
hpsc-dashboard --out site --history data/history.jsonThis writes site/index.html (one self-contained file) and site/data.json. It needs HPSC_EMAIL and HPSC_PASSWORD for a free account on healthproductshortages.ca.
Daily auto-publishing (GitHub Pages)
.github/workflows/daily-dashboard.yml rebuilds the dashboard every day at 14:00 UTC, saves one trend point to data/history.json, and publishes the site. To turn it on in your copy of the repo:
Settings > Secrets and variables > Actions > Secrets: add
HPSC_EMAILandHPSC_PASSWORD.Settings > Secrets and variables > Actions > Variables (optional): add
SITE_AUTHOR(your name) andSITE_AUTHOR_URL(e.g. your LinkedIn profile).Settings > Pages > Build and deployment > Source: choose GitHub Actions.
Actions tab > Daily dashboard > Run workflow to publish the first version now.
The MCP server
Lets Claude answer questions like:
"Is amoxicillin 500 mg in shortage right now? When is it expected back?"
"Check these 30 DINs from our formulary and tell me what's affected."
"List all current Tier 3 shortages."
"DIN 02242705 is short. What other marketed products have the same ingredient, and are any of those short too?"
It connects to two official sources:
Source | What it gives | Account? |
Health Product Shortages Canada API (healthproductshortages.ca) | Shortage and discontinuation reports, status, reason, dates, Tier 3 | Yes, free. 1,000 requests/hour |
Health Canada Drug Product Database API (health-products.canada.ca/api/drug) | Ingredients, strength, form, route, ATC, marketing status | No |
Tools
Tool | What it does |
| Search by name, ingredient, company or DIN, with optional status filter |
| Full detail of one shortage or discontinuation report |
| Check up to 50 DINs or names at once; flags OK / AFFECTED / TIER 3, and notes when a drug's only reports are past their end date or not updated in 12+ months |
| Current Tier 3 (highest-impact) reports |
| Newest updated reports by status, for a daily digest |
| Drug details from the Drug Product Database |
| Same-ingredient, same-form, same-route marketed products, each checked for shortages |
| Scans every open report and returns summary numbers: past end date, not updated, duplicates, partial supply, companies with the most overdue reports |
| Builds the dashboard from live data and saves it on your computer |
Every report carries a quality block: the freshness label, a check_with_supplier flag, days past the estimated end date, days since the last update, any partial-supply note ("100 BTL available"), and how many open reports exist for the same DIN.
Setup (about 10 minutes)
Create an account on https://healthproductshortages.ca and verify your email. Accounts that existed before the January 2026 site move must reset their password first.
Install (needs Python 3.10+):
pip install .Add to Claude Desktop (Settings > Developer or Extensions > Edit config):
{ "mcpServers": { "health-product-shortages-canada": { "command": "hpsc-mcp", "env": { "HPSC_EMAIL": "you@example.com", "HPSC_PASSWORD": "your-password" } } } }If Claude can't find
hpsc-mcp, use the full path topythonwith"args": ["-m", "hpsc_mcp.server"].Fully quit and reopen Claude Desktop, then ask: "Search Canadian drug shortages for amoxicillin."
Quick login test: curl.exe "https://healthproductshortages.ca/api/v1/login" -D - -X POST --data-urlencode "email=YOU" --data-urlencode "password=PASS" should return 200 and an auth-token header.
Tests
pip install -e ".[test]"
pytestTests use simulated responses and need no network or account.
Notes and limits
The API base is
https://healthproductshortages.ca/api/v1(setHPSC_BASE_URLto override). Multi-report pulls sort by report ID ascending with 100 per page, as the API docs require. Results are cached for 10 minutes.For the whole database, the reporting site recommends its monthly data extract; this project only pulls open reports plus the 100 most recently resolved.
find_alternativesonly matches the same active ingredients, form and route. It does not suggest therapeutic substitutes and does not check provincial formulary coverage. Controlled drugs cannot be therapeutically substituted by pharmacists.Report links use
healthproductshortages.ca/shortage/<id>(confirmed); discontinuation links assume/discontinuance/<id>.Check the reporting site's terms of use before republishing its data or using it commercially.
License
MIT. Data © its respective sources; see healthproductshortages.ca.
Available Tools
9 toolsbuild_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).
Inputs: author, repo_url, author_url, output_dir.
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.
Inputs: items (required), include_anticipated.
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.
Inputs: top_n, max_pages, include_anticipated.
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.
Inputs: din (required), max_candidates, check_shortages.
get_reportB
Get the full detail of one report.
Args: report_id: The report number shown on healthproductshortages.ca. report_type: "shortage" or "discontinuation".
Inputs: report_id (required), report_type.
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).
Inputs: query, max_pages, include_discontinued.
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.
Inputs: din, brand_name.
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.
Inputs: limit, status.
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.
Inputs: din, limit, query, offset, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
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.
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.
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.
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.
Related MCP Connectors
Your lab results and health record in Claude: trends, retests, meds, conditions and symptoms.
Telehealth support for Claude, Codex and Cursor: investigate cases and connect your tools.
Health Canada Drug Product Database (fleet #522).
Drug-drug interaction checker for clinical LLMs using RxNorm and DailyMed.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceEnables integrated search and ordering across eight pharmaceutical wholesalers to compare prices and manage inventory. Users can monitor stock levels and execute orders through natural language commands in Claude.-
- AlicenseAqualityDmaintenanceAn MCP server that lets an LLM answer a pharmacist's question about drug shortages by normalizing drug names, finding pharmacologic alternatives, and checking their shortage status using public FDA and NLM data.5MIT
- AlicenseNot gradedqualityBmaintenanceEnables querying the Health Canada Drug Product Database for approved drugs, including brand names, DINs, active ingredients, strengths, dosage forms, routes, and market status.87 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to query authoritative sources such as FDA, WHO, PubMed, RxNorm, and ClinicalTrials.gov for drug information, health statistics, medical literature, pediatric guidance, and clinical guidelines. Runs locally with no API keys required and includes resilience features like caching, rate limiting, circuit breakers, and health checks.74 npmISC