Appearance
Tools Reference
SaveHealth provides 4 tools that run in sequence: search, options, prices, coupon.
Quick Reference
| Tool | Step | What you provide | What you get | Purpose |
|---|---|---|---|---|
search_drug | 1 | Drug name | Matching drug names | Find a drug by name |
get_drug_options | 2 | Selected drug | Dosage, form, quantity options | Choose dosage/form/quantity |
get_drug_prices | 3 | Selected option + quantity | Prices per pharmacy | Compare pharmacy prices |
get_coupon | 4 | Selected pharmacy | Coupon details (BIN, PCN, etc.) | Get coupon for a pharmacy |
INFO
If you already have an NDC from your prescription bottle, skip directly to step 3 (get_drug_prices).
Tool Annotations
All 4 tools are read-only and safe to call. They never modify anything or store data.
Step 1: search_drug
Purpose: Fuzzy search for a drug by name. Handles misspellings, brand names, and partial matches.
You provide: The drug name (e.g., "lisinopril", "Lipitor", "atorvstatin").
You get back:
- A list of matching drug names
- Whether disambiguation is needed (when there are multiple matches)
Important
When multiple drugs match, all suggestions are presented and you must pick one before proceeding.
Single match: Proceeds automatically to the next step.
Multiple matches: A list is presented:
- Lisinopril
- Lisinopril-hydrochlorothiazide
- Zestril
- Qbrelis
- Zestoretic
No results: Try the generic name instead of the brand name, or check for typos.
Step 2: get_drug_options
Purpose: Returns all available dosage strengths, forms, and quantities for a drug. Options are sorted Generic first, Brand second, with the default option marked.
You provide: The drug selected in step 1. Optionally, a specific dosage to filter by (e.g., "20mg").
You get back:
- All available options with dosage, form, and quantity
- Generic vs Brand label for each option
- The recommended default option highlighted
- Available quantities for each option (e.g., 30, 60, 90 tablets)
Example:
Name Type Dosage Form Default Qty Available Quantities Lisinopril Generic 20MG Tablet 30 30, 60, 90, 135, 180 Zestril Brand 20MG Tablet 30 30, 60, 90, 135, 180
TIP
The Generic vs Brand label helps identify cheaper generic alternatives.
Step 3: get_drug_prices
Purpose: Returns real-time pharmacy prices for the selected drug and quantity. Prices are sorted cheapest first.
You provide: The option chosen in step 2, plus the quantity.
You get back:
- Prices from up to 4 pharmacies (Walmart, CVS, Walgreens, Albertsons)
- Sorted from cheapest to most expensive
- The lowest price highlighted
Example:
Pharmacy Price Albertsons $9.74 Walgreens $9.79 Walmart $15.52 CVS $18.93
Step 4: get_coupon
Purpose: Returns coupon/discount card details for a specific pharmacy.
You provide: The pharmacy you want the coupon for (from the price list in step 3).
You get back:
- Pharmacy name
- Discounted price
- Complete discount card: BIN, PCN, Group ID, Member ID
- Instructions for the pharmacist
Example:
Your coupon for Albertsons:
- Price: $9.74
- BIN: 011867
- PCN: HT
- Group ID: LABH001
- Member ID: MC2D0DCCD0
Present this information at the pharmacy counter.
TIP
The coupon fields (BIN, PCN, Group ID, Member ID) are everything the pharmacist needs to process the discount.