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.
输入参数ndczipdrugformlocalechannelquantitystrengthcompare_to
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.
输入参数zipformslug必填wherelocalequantitystrengthcompare_to
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.
输入参数zipdrugformlimitchainsfamilylocalequantitystrength
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.
输入参数zipformslugwherefamilylocalequantitystrength
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.
输入参数zipdrugformchainlocalequantitystrength
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.
输入参数zipdrugs必填localechannel
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.
输入参数zipformsslugs必填wherelocalestrengthsquantities
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.
输入参数querylocale
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.
输入参数q必填locale
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.
输入参数druglocalechannel
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.
输入参数limitquery必填locale
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.
输入参数slug必填localechannel
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.
无需输入参数。
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.
输入参数druglocale
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.
输入参数brand必填localechannelcountry
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.
输入参数brands必填localechannelcountry
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.
输入参数localebrand_slug必填
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.
输入参数slug必填