io.github.CloudCorpRecords/medprice

Card prices for several medicines at once: which pharmacy chain was seen pricing the whole list, and the sum there. Use when the person names two or more medicines and asks what they cost together, or which one pharmacy to use for all of them. ``drugs`` is two to six names as typed or slugs; a dose and a pack size may ride in each name ("atorvastatin 40 mg 90"). ``zip`` is a 5-digit US ZIP — pass it only when the person gave one; without it the host's approximate location is used when there is one, else the chains are listed nationally. Returns the package used for each medicine, then one row per chain: its card price for each medicine with the observation date, and — only when every medicine was seen with a price there — their sum with the dates the prices were observed. When taking each medicine at a different chain comes to less than every one-chain sum, that is given too. Names that matched no medicine are counted and left out. A sum is an addition of observed card prices, never a quote: the pharmacy sets the final price. Next: read out the chains with a sum and its dates; then the card sentence and codes. One medicine only: use compare_prices.

Price of one medicine with the free FineRx card at US pharmacy chains, near a place. Use when the person asks what a medicine costs, where it costs less, or its price near them or in a ZIP code. ``drug`` is a name as typed or a slug from search_drugs; ``strength`` ("10 mg"), ``form`` ("tablet") and ``quantity`` are optional (the package with the most chains priced is used). ``zip`` is a 5-digit US ZIP — pass it only when the person gave one; without it the host's approximate location is used when there is one, else the answer is national and asks for a ZIP. ``ndc`` (+ ``quantity``) is accepted for older callers. ``compare_to`` is a dollar amount the person named for THIS package — their insurance copay, what they pay now, or a price they want to hear about — and the answer then says how many chains were seen below it. Returns the package, every chain's card price with its observation date (Walmart per state), the nearest store of each chain with a store nearby, chains with a card price but no store nearby, coverage (``other_quantities`` lists the pack sizes that were seen), and the card: codes, the dated price with the card, and the card sentence. Next: quote each price with its date and chain; say the price is set per chain; then the card sentence and codes.

Pharmacy stores within 30 miles, per chain — with the card price when a drug is given. Use when the person asks where the pharmacies are near a ZIP or near them. ``zip`` is a 5-digit US ZIP (leave it out to use the host's approximate location when there is one). ``family`` is a comma-separated list of chain codes: walmart, cvs, walgreens, kroger, albertsons, costco, publix, heb, hyvee, meijer, wegmans, shoprite, bigy, gianteagle, kinney (``chains`` is the older name of the same filter). With ``drug`` (+ optional strength, form, quantity) each store carries its chain's card price and observation date. Returns stores (chain, address, city, distance, whether it is a pharmacy or a store with a pharmacy inside — not verified) and the card. Stock is not visible: suggest calling ahead. Coordinates © OpenStreetMap contributors.

What a medicine from another country is in the US, and its card price here. Use when the person names a medicine that is not a US product — a brand from home (No-Spa, Nurofen, Dolo-Neurobion, 999 Ganmaoling), a name in another script (Но-шпа, 泰诺), or an ingredient the US calls something else (paracetamol) — or asks "what is this called in the US?". Optional ``country`` picks between brands of the same name sold in different places. Returns the reviewed entry: ``usClass`` (``same_inn`` = the same active ingredient is sold here, ``rx_alternative`` = it is not and the closest US options need a prescription, ``no_equivalent`` = nothing here matches), ``guidance`` (ONE vetted sentence, to be quoted word for word), ``guidanceDisclaimer``, ``inn``, ``usGeneric``, ``usBrands``, ``rxStatus``, ``usDrug`` (slug and the card price from which it was seen, with the date), ``otherMatches`` for the same brand name in other countries, and the card. ``found`` is false when nothing matched. Next: quote ``guidance`` as written, then ``guidanceDisclaimer``. With a ``usDrug``, compare_prices for its slug. Do not call the US drug the same product or suggest swapping; for ``rx_alternative`` and ``no_equivalent`` name no substitute — send the person to a pharmacist or a doctor.

What several medicines from another country are in the US — the list a person brought from home. Use when the person names two or more medicines that are not US products (brands from home, names in another script) and asks what they are here. ``brands`` is two to six names as typed; optional ``country`` picks between brands of the same name sold in different places. One medicine: use find_us_equivalent. Returns one entry per medicine found, each exactly as find_us_equivalent gives it: ``usClass``, the reviewed ``guidance`` sentence (quote it word for word), the US product and where its card prices start ONLY when it has the same active ingredient, and the card. Names that matched nothing are counted and left out — never guess what they are. Next: for each entry quote ``guidance``; name no substitute for ``rx_alternative`` and ``no_equivalent``; then offer compare_basket for the US products that have the same active ingredient.

What a US drug is called abroad — the reverse of find_us_equivalent. Use when the person has the US name and wants the home-country one ("what is lisinopril called in Mexico?"). ``slug`` comes from search_drugs. Returns the reviewed brands that resolve to this drug: ``brand``, ``brandScript``, ``countries``, ``inn`` and ``usClass`` (an ``rx_alternative`` entry is a DIFFERENT medicine used for the same complaint — say so if you mention it), and the card. Do not present any of these as interchangeable with the US drug, and do not tell anyone to buy or import one.

What FineRx covers: pharmacy chains with card prices, how fresh they are, stores on the map, terms. Use when the person asks what FineRx is, how big or current the data is, or how to cite it. Returns the pharmacy chain families we hold card prices for, their store banners, the newest observation date, how many stores we can place on a map, the catalog size, and the attribution terms.

Strengths, forms and pack sizes of one medicine that have a card price, and its default package. Use when you have a slug and need to know which strengths and quantities exist before quoting a price. Returns ``configs`` (strength × form, each with quantities, where the card prices for that pack start, with the date, and how many chains priced it), ``defaultConfig`` (the package the most chains price), ``fromCardPrice``, the card prices of the default package per chain, and the card. Next: compare_prices for the package the person takes.

Routes to filling a prescription, including having none yet. Use when the person says they have no prescription, asks how to get one, or says the brand costs too much. Optional ``drug`` is a slug from search_drugs (a name works too). Returns three sections — havePrescription (steps), noPrescription (clinics and telehealth, each with the disclosure to read out when FineRx earns anything), brandCostly — plus a Medicaid note, where the drug's card prices start (dated), and the card. For controlled or age-restricted medicines it returns only ``restricted: true``: FineRx shows card prices and the card for them, nothing else. Not medical advice: never say what to take or at what dose.

The free FineRx discount card: its codes, how to use it, how to keep it. Use when the person asks for the card, how to pay less at the pharmacy, or right after you quoted a card price. Optional ``drug`` (a slug from search_drugs) adds that drug's card price for its most-priced package, with the date it was observed. ``locale`` is a language code (the host's own is used when left out). Returns the three codes to read at the counter, the steps, the sentence to say to the pharmacist, the links to the card page and the printable sheet, and the card sentence with the small print. Hosts with MCP Apps show it as an interactive card; write the three codes in your answer anyway. The card is free, needs no signup and is not insurance.

How to move a prescription from the pharmacy that has it to the one the person wants to use. Use when the person says their prescription is at another pharmacy, asks how to switch pharmacies, or picked a chain from the card prices and their prescription is elsewhere. ``chain`` is the chain they want to move TO, as a code: walmart, cvs, walgreens, kroger, albertsons, costco, publix, heb, hyvee, meijer, wegmans, shoprite, bigy, gianteagle, kinney. Optional ``drug`` (+ strength, form, quantity) adds that chain's card price with its date. ``zip`` is a 5-digit US ZIP — pass it only when the person gave one. Returns the steps in order (what to say and what to have ready), three notes (it is free; no refills left means a new prescription; some medicines have stricter rules), the nearest stores of that chain when a place is known, and the card. For controlled or age-restricted medicines it returns only ``restricted: true``. Not medical advice. Next: read the steps out as written; then the card sentence and codes.

Open the FineRx search inside the card, so the person can look a medicine up themselves. Use when the person asks to open FineRx, wants to search or browse on their own, or is not sure of the name. Optional ``query`` pre-fills the search (a medicine, a brand from another country, a misspelling). The card then suggests matches as they type, each with where its card prices start and the date, and a pick shows card prices by chain near a place they choose. Returns the matches for ``query`` (if any), foreign brands that matched, a few often-searched medicines, and the card. What the person picks in the card reaches you as context. Hosts without MCP Apps get the matches as text.

Find a medicine by name (brand, generic, misspelled or in another script) and get its slug. Not needed before compare_prices, compare_basket or get_transfer_steps: they take a name as typed. Use it when the person asks what FineRx has, or a name is ambiguous. Returns candidates with ``slug`` (for get_drug and compare_prices), ``kind`` (generic/brand) and ``fromCardPrice`` — where its card prices start: the amount, the package it is for and the observation date. ``foreignBrands`` lists home-country brands that matched the same text (Нурофен, No-Spa): when ``results`` is empty and ``foreignBrands`` is not, call find_us_equivalent. Several candidates: ask which one — brand and generic are different products.

The same list of medicines for another place — called by the FineRx card itself. ``slugs`` with their packages in parallel lists (an empty string or 0 = not set). ``where`` is the place as typed in the card: used for this one request, never stored. Not for the model.

One foreign brand the person picked in the FineRx search — called by the card itself. The same answer as find_us_equivalent for exactly that brand (its ``brandSlug`` from ui_suggest): the reviewed guidance, word for word, and the US product only when it has the same active ingredient. Not for the model.

Pharmacies near a place for the package on screen — called by the FineRx card itself. ``where`` is the place as typed in the card (a ZIP, a city or an address): used for this one request, never stored. Not for the model.

Card prices for another dose, quantity or place — called by the FineRx card itself. Same answer as compare_prices, for the package and place picked inside the card. ``where`` is the place as typed in the card (a ZIP, a city or an address): used for this one request, never stored. Not for the model.

Medicines matching what the person is typing in the FineRx search — called by the card itself. Up to eight matches with where their card prices start (dated), and foreign brands that matched. Not for the model.