Formulary MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Formulary MCP Serversearch for metformin in CA"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Unofficial US Commercial Insurance Formulary MCP Server
Model Context Protocol (MCP) server providing unified access to drug formulary data from US ACA marketplace health insurance plans.
Features
Unified drug search across ~15,000 plans from ~735 issuers
Coverage details: tier levels, copays, coinsurance
Restriction info: prior authorization, step therapy, quantity limits
Plan comparison: compare drug coverage across plans
State filtering: filter results by state
Full-text search: fast drug name search with FTS5
Related MCP server: Benefits Agent MCP Server
Installation
cd formulary-mcp-server
npm installOption 1: Download Pre-built Database
npm run download:dbOption 2: Build Database from Source
# Download issuer index from CMS
npm run download:index
# Download formulary files for all issuers
npm run download:files
# Build SQLite database
npm run build:dbBuild and Run
npm run build
npm startUsage
{
"mcpServers": {
"formulary": {
"command": "node",
"args": ["/path/to/formulary-mcp-server/build/index.js"]
}
}
}Tool: formulary_info
Single unified tool with multiple methods:
Methods
Method | Description | Required Params |
| Search drugs by name |
|
| Get full drug info with coverage |
|
| Get drugs covered by a plan |
|
| Get plan info and tier structure |
|
| Compare drug across plans |
|
| Search plans by state/issuer | - |
| Get PA/ST/QL requirements |
|
| Find drugs in same tier |
|
| Get database statistics | - |
Example Usage
Search for a drug:
{
"method": "search_drug",
"drug_name": "metformin",
"state": "CA",
"limit": 10
}Get drug details:
{
"method": "get_drug_details",
"rxnorm_id": "860975",
"state": "CA"
}Compare coverage:
{
"method": "compare_coverage",
"rxnorm_id": "860975",
"state": "TX",
"limit": 20
}Get plan formulary:
{
"method": "get_plan_formulary",
"plan_id": "12345VA0010001",
"tier": "GENERIC"
}Get restrictions:
{
"method": "get_restrictions",
"rxnorm_id": "860975",
"plan_id": "12345VA0010001"
}Response Format
Drug Search Response
{
"method": "search_drug",
"query": "metformin",
"count": 5,
"results": [
{
"rxnorm_id": "860975",
"drug_name": "Metformin Hydrochloride 500 MG Oral Tablet",
"plan_count": 245,
"tiers": ["GENERIC", "PREFERRED-BRAND"]
}
]
}Drug Details Response
{
"method": "get_drug_details",
"drug": {
"rxnorm_id": "860975",
"drug_name": "Metformin Hydrochloride 500 MG Oral Tablet"
},
"coverage_summary": {
"total_plans": 245,
"plans_with_pa": 12,
"plans_with_st": 5,
"plans_with_ql": 89
},
"coverage": [
{
"plan_id": "12345CA0010001",
"drug_tier": "GENERIC",
"prior_authorization": false,
"step_therapy": false,
"quantity_limit": true,
"marketing_name": "Blue Shield Gold",
"issuer_name": "Blue Shield of California",
"copay_amount": 10.00,
"coinsurance_rate": 0.20
}
]
}Data Coverage
Aspect | Coverage |
Plans | ~5,500 ACA marketplace plans |
Issuers | ~150 insurance companies |
Drugs | ~13,000 unique medications |
Templates | ~800 unique formulary templates |
States | 15+ states |
Data | Tier, PA, step therapy, quantity limits |
Data Source
Data is sourced from the CMS QHP (Qualified Health Plan) Provider & Formulary APIs:
Note: This covers ACA marketplace plans only. Employer-sponsored and Medicare Advantage plans are not included.
License
MIT
References
This server cannot be deployed
Maintenance
Related MCP Connectors
US healthcare public data, one endpoint: prices, Medicare, MA benefits, Stars, Medicaid, providers.
Live US drug acquisition costs (CMS NADAC) for AI assistants. Free, no auth, weekly data.
US medication lookup: drug search, forms and strengths, NDC/RxCUI, recalls, shortages.
Pay-per-call US healthcare data: hospital financials, prices, quality, exclusions, wages.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides access to Medicaid public data including drug pricing (NADAC), state enrollment trends, federal upper limits, drug rebate information, and utilization statistics through a hybrid CSV caching and DKAN API approach.12MIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables healthcare benefits management by providing member eligibility verification, coverage details for medical/dental/vision/pharmacy services, and service coverage verification through natural language queries.-
- AlicenseBqualityCmaintenanceProvides comprehensive access to CMS Medicare data including physician services, prescriber information, hospital quality metrics, drug spending, formulary coverage, and ASP pricing for healthcare analysis and decision-making.18MIT
- AlicenseNot gradedqualityCmaintenanceUnifies five public US-government drug datasets into a single sourced page per GLP-1/cardiometabolic drug, providing cost, shortage, label, and alternatives. The MCP server exposes the same Drug contract as the UI for agent-native access.31,975,888 npmApache 2.0