finerx-mcp 1.0.0

MCP server exposing FineRx drug-price data to AI agents (thin client over the FineRx public REST API).

FineRx MCP server

Give an AI assistant live access to FineRx drug-price data — the same catalog, package, price-comparison, and nearest-pharmacy data shown on the FineRx website — through the Model Context Protocol.

finerx-mcp is a thin client over the FineRx public REST API (/api/public/v1). It has no direct database access and inherits the public API's authentication and rate limits, so it adds zero extra attack surface.

Tools

Tool	What it does
search_drugs(query, limit=10)	Find drugs by name/alias → candidates with slugs + from-prices
get_drug(slug)	A drug's stats + strength/form variants
compare_prices(ndc, quantity)	Offer matrix (chain × savings program × price × observation date)
find_nearby_pharmacies(zip, chains?, limit=3)	Nearest store locations per chain around a ZIP
get_dataset_info()	Dataset coverage, freshness, and attribution/disclaimer terms

Every result embeds a one-line disclaimer and, wherever a price appears, an observedAt date. No tool ever returns hidden vendors or an operator reference price.

Prerequisites

• A FineRx developer API key (format frx_live_...). Request one by emailing [e-mail] — see https://finerxfinder.com/developers.
• uv installed (provides uvx).

Configuration

The server reads two environment variables:

Variable	Required	Default	Notes
FINERX_API_KEY	yes	—	Your frx_live_... key
FINERX_API_BASE	no	https://finerxfinder.com/api/public/v1	Point at another host for local testing

Install & run

Run directly with uvx (no manual install needed):

FINERX_API_KEY=frx_live_xxxxxxxx uvx finerx-mcp

The server speaks MCP over stdio.

Claude Desktop

Add to your claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

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

Restart Claude Desktop; the FineRx tools appear in the tools menu.

Claude Code

claude mcp add finerx --env FINERX_API_KEY=frx_live_xxxx -- uvx finerx-mcp

Or add it to .mcp.json in your project:

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

Local development

Run against a local FineRx stack (e.g. the dev proxy on :8080):

export FINERX_API_KEY=frx_live_...        # a key you created via the CLI
export FINERX_API_BASE=http://localhost:8080/api/public/v1
uv run --project packages/finerx-mcp finerx-mcp

A smoke test that drives one tool call end-to-end lives at scripts/smoke_mcp.py in the FineRx repo.

Terms

Data is provided under the FineRx public API terms: attribution required ("Prices via FineRx"), prices are observed estimates (not guaranteed or insured prices) and may be out of date, and nothing here is medical advice. Pharmacy location coordinates are © OpenStreetMap contributors (ODbL).