Developers

FineRx API & MCP server

Bring FineRx price data into your own app or AI assistant. A read-only REST API exposes the same drug, package, and price-comparison data shown on the website — plus nearest pharmacy locations — and an MCP server lets AI agents query it directly.

What the API offers

The public API is read-only and returns exactly what the website shows: drugs, their packages (NDCs), price comparisons across pharmacy chains and savings programs, and nearby pharmacy locations. Every price is dated, and every response carries a source and disclaimer. It never exposes hidden vendors, raw source rows, or internal reference prices.

Endpoints

All endpoints live under the versioned base path and return JSON:

Endpoint	Description
GET /api/public/v1/drugs/search?q=	Search drugs by name or alias; returns candidates with slugs and lowest observed price.
GET /api/public/v1/drugs/{slug}	A drug's stats and its strength/form variants.
GET /api/public/v1/drugs/{slug}/packages	The packages (NDCs) available for a drug, with a from-price and data freshness.
GET /api/public/v1/prices/compare?ndc=&quantity=	The offer matrix for one package: chain × savings program × price × observation date.
GET /api/public/v1/pharmacies/nearby?zip=	Nearest pharmacy locations per chain around a US ZIP code.
GET /api/public/v1/meta	Dataset coverage, freshness, and the attribution/disclaimer terms.

Interactive OpenAPI docs (with an "Authorize" button) are at /api/public/v1/docs and the machine-readable schema sits beside them.

Authentication

Every request needs a developer key (format frx_live_...), sent as either header:

Authorization: Bearer frx_live_...
X-Api-Key: frx_live_...

curl -H "X-Api-Key: frx_live_..." \
  "https://finerxfinder.com/api/public/v1/drugs/search?q=atorvastatin"

Requests are rate-limited per key: 60 per minute and 5,000 per day. Exceeding a limit returns HTTP 429 with a Retry-After header.

Requesting a key

There is no self-serve signup yet — keys are issued on request. Tell us what you're building and email us at partners@finerxfinder.com.

MCP server (for AI agents)

The finerx-mcp package is a thin client over this API that exposes FineRx as tools to an AI assistant. Run it with uvx finerx-mcp and add it to your MCP client config:

{
  "mcpServers": {
    "finerx": {
      "command": "uvx",
      "args": ["finerx-mcp"],
      "env": { "FINERX_API_KEY": "frx_live_..." }
    }
  }
}

It provides five tools:

search_drugs — find drugs by name
get_drug — a drug's stats and variants
compare_prices — the offer matrix for a package
find_nearby_pharmacies — nearest pharmacies by ZIP
get_dataset_info — coverage, freshness, and terms

Attribution & disclaimer terms

Use of the API is subject to these terms:

Attribution is required: display "Prices via FineRx" wherever you show FineRx data.
Prices are recently observed estimates from third-party savings programs — not guaranteed or insured prices — and may be out of date. Do not represent them as guaranteed.
The data is not medical advice.

See also our methodology · terms of service · privacy policy.