fairpractice2-agents
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Fairpractice wave 2: medical practice, pharmacy and hospital admin agents (ver 1)
English · Deutsch · Français · Español · Português · Italiano · 日本語 · 简体中文 · 한국어
30 more MCP agents for medical practices, clinics, pharmacies, health centers and hospitals, adding to the first 30 Fairpractice agents. They were picked from the medical agents catalog by its own ranking and cover credentialing and provider operations, payers and prior authorization, coding integrity, pharmacy admin and money, scheduling and intake, patient financial aid and collections, and hospital and facility finance. Each one reads files the customer already exports, flags what a credentialing coordinator, biller, pharmacist in charge or finance lead would catch by hand, and writes a CSV worklist and an HTML report for staff.
Built on fairclaim-core (masking, policy, approvals, audit log, MCP server, memory, reading exports in nine languages, nine-language report pages) and fairpractice-core 0.2.0 (the first wave's helpers plus NDC and code-list matching, poverty-guideline percentages and hospital and pharmacy column names; additions only).
Administrative and financial only. No diagnosis, no treatment advice, no agent reads clinical notes, and none suggests a diagnosis or procedure code. The coding integrity agents check codes, dates and statuses people already entered.
Local files only. No logins to an EHR, a pharmacy system, a PBM or payer portal, a clearinghouse, a state system or a bank. No network calls, no telemetry. You download the lists (NPPES rows, payer authorization lists, coverage lists, the Medicaid Exclusion File, a cost benchmark) and point the agent at them.
Masked before the model sees it. Patient, staff and provider names become pseudonyms, record and account numbers become
MRN-…andACCT-…, phone numbers are removed. Report files on disk keep real values for staff.People send. Every agent refuses the binding action next to its job (submitting claims, appeals or authorizations, paying invoices, filing DEA or cost reports, sending texts, placing accounts with agencies, changing the chargemaster). Refused tools are listed so a model can see they exist and are refused.
Settings, not hard-coded rules. Thresholds, windows, tiers, state rules and payer days are JSON settings you pass; a misspelled setting is refused by name. The sample settings are labeled examples.
Fictional data only. Every patient, provider, payer, PBM, vendor and hospital in the fixtures is made up; NPIs pass the check digit but belong to no one.
Masking covers the names and numbers the agents know about; free text (descriptions, reasons) is sent with known names replaced, and results go to whatever model your assistant uses (docs/model-view.md). It is not de-identification or a HIPAA compliance determination, and not legal, billing, coding, tax, pharmacy or clinical advice. Column names were written from general knowledge of common exports; the CMS NPPES file and the NADAC file were run as published (docs/realdata.md), the other layouts have not been checked against real exports. A business associate agreement is signed before any real patient file is held.
Try it
npm install
npm test
node packages/fairpractice-pbm-reimbursement/bin/fairpractice-pbm-reimbursement.js demo
node packages/fairpractice-prior-auth-lists/bin/fairpractice-prior-auth-lists.js demoRelated MCP server: fairshop-agents
The 30 agents
Credentialing and provider operations
Agent | What it checks |
NPI, name, taxonomy and address checks: your provider roster against the NPPES file you download, with invalid or deactivated NPIs, names and taxonomies that do not match, practice ZIPs that differ, duplicate NPIs and records not updated in a long time. | |
NP and PA supervision and collaboration agreements: nurse practitioners and physician assistants with no current agreement, agreements expired or expiring, supervisors who left, more NPs and PAs per physician than your state setting allows, and chart reviews below the agreed share. | |
Locum tenens and reciprocal billing: claims billed under an absent physician past the 60-day limit, claims in a locum period without the Q5 or Q6 modifier, the modifiers used with no assignment on file, contracts that ended and locums billing before their own enrollment. | |
Hospital medical staff privileges: reappointments overdue or coming due, procedures done with no current privilege for them, temporary privileges past their limit, inactive staff who still hold privileges and privileges with fewer cases than your setting. |
Payers and prior authorization
Agent | What it checks |
Prior authorization requirements: each scheduled service checked against the payer authorization lists you download (single codes, ranges and wildcards), with missing authorizations, urgent ones close to the visit, codes newly added to a list and payers with no list loaded. | |
Prior authorization workload: open requests by age and payer, decisions past your payer's decision days, services coming up while still pending, peer-to-peer dates, approvals with fewer units or another code, and denials whose appeal window is closing. | |
Medicare Advantage against traditional Medicare on the same services: denial rate, paid code differing from billed code, days to pay and paid per unit, with the codes where Advantage plans fall behind by more than your settings. | |
Payer and auditor record requests (ADR, RAC, UPIC, TPE and commercial audits): responses overdue or due soon, records sent late, adverse results with the appeal window closing or missed, and money taken back while a timely appeal was pending. | |
Medicaid renewal dates: patients whose renewal is past or close, coverage that eligibility responses show as ended or moved to another plan, Medicaid patients with no renewal date, and appointments booked after coverage ends. |
Coding integrity (no reading of notes, no code suggestions)
Agent | What it checks |
Chargemaster (CDM) audit: lines with codes not in the code file you download, missing or malformed revenue codes, code and revenue code pairs outside your rules, prices below cost, zero prices, the same code priced far apart and duplicate charge numbers. | |
Unsigned and open encounters holding claims, by provider: counts, dollars on hold and days old against your signing policy, and claims at risk of the filing limit. It reads encounter status only and never opens or reads a note. | |
Coverage list checks: each billed service checked against the coverage lists (LCD or NCD style) you download, for a listed diagnosis already on the claim, with Medicare services needing an ABN and none on file, ABNs without the modifier your policy uses, and lists out of date. It never suggests codes. | |
The three-day payment window: outpatient diagnostic services in the days before an admission that belong on the inpatient claim, non-diagnostic services for a person to review, and the dollars billed separately, with ambulance and maintenance dialysis left out. | |
Late charges: charges posted after the claim went out, charges posted later than your lag policy, old charges with no claim yet, and the lag by department in days and dollars. |
Pharmacy (admin and money only)
Agent | What it checks |
340B duplicate discount checks: 340B drugs billed to Medicaid where you carved out, Medicaid fee-for-service claims when you are not on the Medicaid Exclusion File you download, 340B Medicaid claims with no 340B identifier, and the identifier on drugs that were not 340B. | |
PBM reimbursement for independent pharmacies: claims paid below your invoice cost, below the published cost benchmark you download or below cost plus your dispensing cost, with losses by PBM and appeal windows closing. | |
PBM audit tracker for pharmacies: audit responses overdue or due soon, claims still missing documents, appeal windows closing or missed, and amounts taken back before the final report. | |
Controlled substance counts (numbers only): purchases, dispensing and counts per drug, shortages and overages against what the records say should be on hand, drugs with activity and no count, Schedule II purchases with no order form number, and the biennial inventory due date. | |
In-clinic (buy-and-bill) drugs: billing units bought against units billed per drug, units bought and never billed, units billed beyond what was bought, claims paid below what the drug cost and drug claims with no NDC. |
Scheduling and intake
Agent | What it checks |
Referral tracking: referrals out not scheduled, referrals in not called back, scheduled referrals not seen, consult reports not back, and referrals sent outside the group for specialties you offer, with an estimated value by specialty. | |
Intake completeness before the visit: consents, insurance cards, photo ID and forms missing or expired for each upcoming appointment, by visit type and day. | |
Text and call consent: messages sent with no consent on file, after an opt-out, outside your quiet hours or for marketing without the consent your policy needs. | |
Price quotes for insured patients: an estimate per visit from your contract rates and the deductible, coinsurance, copay and out-of-pocket left, with quotes missing before the visit, quotes far from the arithmetic, and services with no rate or benefits on file. |
Patient financial aid and collections
Agent | What it checks |
Financial assistance (501(r) style) checks for nonprofit hospitals: discounts below your policy tier, eligible applicants denied, eligible patients billed above amounts generally billed, collection actions too early, without notice or while an application was pending. | |
Sliding fee discounts for health centers: the tier from income and household size against your poverty-guideline tiers, discounts short or over, wrong tiers on file, and visits after income proof expired or with no proof. | |
Collection agency placements: accounts sent before your wait period (with state settings), under your credit-reporting floor, with an insurance claim still open, a pending aid application, an active payment plan or no balance left. | |
Medicare bad debt: which accounts meet your collection-effort settings to be listed on the cost report and which do not, and why: too early, still at an agency, payment restarted the clock, no Medicaid remittance for dual eligibles, undocumented indigence or not written off. |
Hospital and facility finance
Agent | What it checks |
Travel and agency staffing invoices: hours billed against your timekeeping, bill rates over the contract, overtime billed before 40 hours or at the wrong rate, guaranteed hours billed without a cancellation, duplicate lines and workers not in timekeeping. | |
Supply and implant pricing: invoice lines above the contract price, items bought off contract, bill-only implants with no purchase order, invoice prices that differ from the PO, duplicate invoices and rebates your spend should earn. | |
Unbilled hospital accounts: discharged not final billed past your days, long stays with an interim bill due, accounts close to the filing limit and holds by reason in counts and dollars. |
Checks
Every agent has at least 24 tests (shared, contract and its own domain tests) and 19 or 20 eval cases on fictional fixtures; the family also runs hostile inputs and arguments, a 10,000-row speed test, the nine-language reading check and an offline release check. The numbers and what is not checked yet are in REVIEW-ver1.md.
npm test
npm run evals
npm run check
npm run accuracy
npm run model-view
npm run settings-list
npm run hostile
npm run hostile:args
npm run intl
npm run bench
npm run release:check:offline
npm run realdata:download && npm run realdataSetups are sold as fixed-price packages on fair-agents.com. The software is MIT licensed.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
License checks, signed rights proof, keyless pre-call checks for MCP servers, and the agent store
MCP gateway with runtime security policy, tool-call-level control, and audit of agent actions.
Run and manage H Company's Computer-Use Agents from any MCP client.
Use a person's computer after they approve it there: files, Terminal, browser, local MCP.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceMCP agents that check business files locally on the user's computer.MIT
- AlicenseNot gradedqualityBmaintenanceMCP agents that check business files locally on the user's computer.MIT
- AlicenseNot gradedqualityBmaintenanceMCP agents that check business files locally on the user's computer.MIT
- AlicenseNot gradedqualityBmaintenanceMCP agents that check business files locally on the user's computer.MIT