Integrate with a PBM's formulary and benefit API to retrieve drug tier, coverage restrictions, and step therapy requirements at the point of prescribing

domain: surescripts.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Access formulary and benefit data through the Surescripts Formulary and Benefit service or a direct PBM API integration; authenticate using OAuth 2.0 client credentials flow with YOUR_CLIENT_ID and YOUR_CLIENT_SECRET
  2. Send a formulary query with patient identifier (member ID or demographics), drug identifier (NDC or RxNorm), and prescriber NPI; receive back FormularyStatus (Covered/NotCovered/NonFormulary), TierNumber, CopayAmount, and CoverageRestrictions array
  3. Parse CoverageRestrictions for codes indicating Prior Authorization Required, Step Therapy Required, Quantity Limit, Age Limit, or Gender Edit; surface these alerts to the prescriber in the order entry workflow
  4. Retrieve step therapy alternative drugs from the response AlternativeMedications list; display alternatives with their tier and estimated patient cost to support shared decision-making
  5. For non-formulary drugs, query formulary exceptions workflow if the PBM supports it; otherwise route to the ePA pathway via NCPDP SCRIPT 2017071
  6. Refresh formulary data at least annually at plan year start (January 1 for most commercial plans) and after any mid-year formulary updates communicated by the PBM

Known gotchas

Related routes

Implement a CMS Patient Access API (CMS-9115 / CMS Interoperability Rule) compliant FHIR endpoint that serves member claims, clinical, and formulary data to authorized third-party apps via SMART on FHIR
cms.gov · 5 steps · unrated
integrate with a payer Patient Access API under the CMS interoperability rule (Da Vinci / CARIN)
payer-patient-access · 6 steps · unrated
Integrate Surescripts Electronic Benefit Verification (EBV) to automate pharmacy benefit lookup for specialty drug patient access teams
surescripts.com · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans