Medprice

io.github.CloudCorpRecordsPublished by GitHub account CloudCorpRecordsv0.1.0Updated Nov 7, 2026

Compare US prescription prices by pharmacy, find nearby pharmacies and drug equivalents.

VerifiedSTDIODesktop onlyLocation & LifestyleFinance

Overview

AI-generated overview

Local bridge to the FineRx prescription-price service, letting an assistant compare US pharmacy card prices, find nearby pharmacies and map foreign drug…

What you can do
  • Search medicines by name, brand, misspelling or another script and get strengths, forms and pack sizes
  • Compare discount-card prices for one medicine or a basket of two to six across US pharmacy chains near a ZIP or place
  • Find pharmacy stores within 30 miles per chain, with card prices when a drug is given
  • Get prescription transfer steps, filling routes when there is no prescription, and the free FineRx discount card details
  • Translate foreign brand names to their US equivalent and back, and report dataset coverage and freshness
When to use it
Useful when someone asks what a US prescription costs, where it is cheaper, which pharmacy is nearby, how to transfer a prescription, or what a medicine bought abroad is called in the US. It is a read-only price lookup, not a clinical or prescribing tool.
Requirements
Runs locally as a Node.js process via npx, or as a Docker container; both speak stdio. It forwards calls to the hosted FineRx endpoint over the network. Optional environment variables FINERX_MCP_URL (endpoint override) and FINERX_API_KEY (sent as a Bearer header) can be set; no account is required by default.
Before you install
Every tool call is forwarded to a third-party hosted service, so the drug names, ZIP codes or places you supply leave the machine. FINERX_API_KEY, if set, is sent upstream as a Bearer token. Prices are discount-card estimates with observation dates, not quotes, and the server returns upstream errors verbatim. One upstream tool that emailed a savings card to an arbitrary address is deliberately not exposed.

Installation

In SourceWeft

  1. Open Medprice in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

medprice

medprice is a small local bridge to FineRx's hosted MCP server, a prescription-price service for the US: it knows what a medicine costs with a free discount card at the major pharmacy chains, which stores sit near a ZIP code, and what a medicine sold under a foreign brand name is called in the US.

The bridge keeps no drug or price data of its own. It serves the upstream server's tool list locally, exactly as captured from the live endpoint, and forwards each tool call upstream, returning the result untouched.

Labelled subset: 18 of 19 tools

The live capture held 19 tools. This rebuild serves 18 of them. One tool is deliberately omitted:

  • email_savings_card — omitted. It sends email to an arbitrary address supplied by the caller, an external-sending action outside this server's price-read core, so it is excluded under the program's safety rule. It is not registered, not forwarded, and the test suite asserts its absence from both the local registry and the served MCP tools/list.

One nearby tool is kept on purpose:

  • get_savings_card — kept. It returns the FineRx program's own free discount card: the shared program codes printed on every card the service distributes publicly, with usage steps. That is published program data, not a user's payment-card data, and it creates no payment instrument — a read like the price reads around it.

Tools

  • compare_prices — one medicine's card price at US pharmacy chains, near a place. Optional: drug, strength, form, quantity, zip, ndc, locale, channel, compare_to.
  • ui_prices — the same price answer for a package and place picked inside the FineRx card. Required: slug.
  • find_nearby_pharmacies — pharmacy stores within 30 miles, per chain, with the card price when a drug is given. All arguments optional.
  • ui_nearby — nearby pharmacies for the package on screen, called by the card itself. All optional.
  • get_transfer_steps — how to move a prescription to another chain. All arguments optional.
  • compare_basket — card prices for several medicines at once, and which chain was seen pricing the whole list. Required: drugs.
  • ui_basket — the same basket for another place, called by the card itself. Required: slugs.
  • open_price_finder — open the FineRx search inside the card. Optional: query, locale.
  • ui_suggest — medicines matching what is being typed in the FineRx search. Required: q.
  • get_savings_card — the free FineRx discount card: its codes, how to use it, how to keep it. See the subset note above. All arguments optional.
  • search_drugs — find a medicine by name (brand, generic, misspelled or in another script) and get its slug. Required: query.
  • get_drug — strengths, forms and pack sizes of one medicine that have a card price. Required: slug.
  • get_dataset_info — what FineRx covers: chains, freshness, store counts, terms. No arguments.
  • get_prescription_options — routes to filling a prescription, including having none yet. All optional.
  • find_us_equivalent — what a medicine from another country is in the US, and its card price here. Required: brand.
  • find_us_equivalents — the same for several foreign medicines at once. Required: brands.
  • ui_equivalent — one foreign brand picked in the FineRx search, called by the card itself. Required: brand_slug.
  • foreign_brands_for_drug — what a US drug is called abroad. Required: slug.

Configuration

  • FINERX_MCP_URL (optional) — override the upstream endpoint. Defaults to https://www.finerxfinder.com/mcp. (The override hook is this rebuild's own labelled reconstruction.)
  • FINERX_API_KEY (optional) — when set, every upstream request carries an Authorization: Bearer <key> header. When it is not set, no auth header is sent. (This forwarding is also a labelled reconstruction; the original surface was captured keyless.)

Forwarding mechanics

On the first tool call the client opens a streamable HTTP session with the upstream: a JSON-RPC initialize request (protocolVersion 2025-03-26, clientInfo name medprice), then a notifications/initialized notification, then the tools/call request carrying the caller's arguments unchanged. When the upstream answers initialize with an Mcp-Session-Id header, that value rides on every later request of the session, which is reused for the life of the process. Replies may arrive as plain JSON or as server-sent events; both are read.

Successful upstream results pass through verbatim, including any isError flag the upstream sets. Failures — a JSON-RPC error, a non-2xx status, an unreadable response, or a request that cannot be completed — come back as an isError result whose text starts with medprice error: (this rendering is this rebuild's own labelled reconstruction).

CLI

Each tool is also a subcommand taking one JSON argument string (omit it for tools that take none):

bash
npx @reneturcios/medprice search_drugs '{"query":"lisinopril"}'npx @reneturcios/medprice compare_prices '{"drug":"lisinopril","zip":"94110"}'npx @reneturcios/medprice compare_basket '{"drugs":["lisinopril","metformin"]}'npx @reneturcios/medprice find_us_equivalent '{"brand":"No-Spa"}'npx @reneturcios/medprice get_dataset_infonpx @reneturcios/medprice --version

Exit codes: 0 on success, 1 on an isError result, 2 on a usage error.

MCP server

bash
npx -y @reneturcios/medprice mcp

MCP client config:

json
{  "mcpServers": {    "medprice": {      "command": "npx",      "args": ["-y", "@reneturcios/medprice", "mcp"]    }  }}

Docker

bash
docker run -i ghcr.io/cloudcorprecords/medpricedocker run --rm ghcr.io/cloudcorprecords/medprice --version

The container's default command is mcp, so the first form is a stdio MCP server; any other arguments reach the CLI normally.

Development

bash
npm installnpm run buildnpm testnpm run dev

The test suite runs entirely against a stubbed JSON-RPC upstream — no live network calls.

License

MIT — see LICENSE.

Source: README.md at commit 7ffcb8d

Tools

18

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.

Parametersndczipdrugformlocalechannelquantitystrengthcompare_to

ui_prices

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.

Parameterszipformslugrequiredwherelocalequantitystrengthcompare_to

find_nearby_pharmacies

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.

Parameterszipdrugformlimitchainsfamilylocalequantitystrength

ui_nearby

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.

Parameterszipformslugwherefamilylocalequantitystrength

get_transfer_steps

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.

Parameterszipdrugformchainlocalequantitystrength

compare_basket

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.

Parameterszipdrugsrequiredlocalechannel

ui_basket

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.

Parameterszipformsslugsrequiredwherelocalestrengthsquantities

open_price_finder

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.

Parametersquerylocale

ui_suggest

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.

Parametersqrequiredlocale

get_savings_card

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.

Parametersdruglocalechannel

search_drugs

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.

Parameterslimitqueryrequiredlocale

get_drug

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.

Parametersslugrequiredlocalechannel

get_dataset_info

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.

Takes no parameters.

get_prescription_options

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.

Parametersdruglocale

find_us_equivalent

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.

Parametersbrandrequiredlocalechannelcountry

find_us_equivalents

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.

Parametersbrandsrequiredlocalechannelcountry

ui_equivalent

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.

Parameterslocalebrand_slugrequired

foreign_brands_for_drug

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.

Parametersslugrequired

Version history

1
  1. v0.1.0LatestNov 5, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts