io.github.costkits/costkits-mcp

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Free hosted MCP server: US healthcare procedure cost estimates and provider pricing. No API key.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "costkits-mcp": {
      "url": "https://mcp.costkits.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (13)

• demo_estimate read-only

  Static sample cost estimate (colonoscopy in Connecticut) from the CostKits API. Works with NO API key — use it to verify connectivity and see the response shape.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• estimate_procedure_cost read-only

  Returns the typical allowed-amount range (low, median, high) for one medical procedure in one US state, the usual billing components (facility, physician, anesthesia, pathology), and the data vintage. If the user chooses to give their own deductible, coinsurance and out-of-pocket figures, it also returns an estimated patient share. These are estimates of typical prices from hospital price transparency and Medicare data, not quotes. Only the procedure and state are required; ZIP code and plan figures are optional and are used only for this one calculation.

  Parameters:

  • procedure (required) — string — Procedure slug or plain name, e.g. 'colonoscopy' or 'mri-knee'. A plain name that is not an exact slug can be matched with resolve_procedure.
  • state (required) — string — 2-letter US state code, e.g. 'CT'. Prices are state-level.
  • zip_code — string — Optional 5-digit ZIP, used only to refine the local estimate
  • plan_type — string — Insurance plan type (default commercial)
  • oop_remaining — number — Dollars left to the member's out-of-pocket max
  • coinsurance_pct — number — Coinsurance percentage, e.g. 20 for 20%
  • deductible_remaining — number — Dollars left on the member's deductible

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• calculate_liability read-only

  Stateless insurance math: given an allowed amount and a plan snapshot (deductible, coinsurance, OOP max), returns exact patient responsibility, plan payment, and the breakdown, plus p25/p75 scenarios. Use when you already have a dollar amount (e.g. from an EOB or a prior estimate).

  Parameters:

  • allowed_amount (required) — number — Negotiated/allowed amount in dollars
  • deductible (required) — number — Annual deductible in dollars
  • coinsurance (required) — number — Coinsurance as a fraction, e.g. 0.2 for 20%
  • oop_max (required) — number — Annual out-of-pocket maximum in dollars
  • copay — number — Flat copay, if the plan uses one
  • oop_met — number — Out-of-pocket already met this year
  • deductible_met — number — Deductible already met this year
  • preventive_exception — boolean — True if ACA preventive $0 cost-sharing applies

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• full_estimate read-only

  One call chaining procedure ontology + cost + providers + patient liability. Cheapest way (one metered request) to get the complete picture. Use `fields` to request a subset; liability requires the plan_* inputs.

  Parameters:

  • procedure (required) — string — Procedure slug or plain name
  • state (required) — string — 2-letter US state code
  • fields — array — Which services to include (default: all)
  • plan_oop_max — number
  • plan_oop_met — number
  • plan_deductible — number
  • plan_coinsurance — number — Fraction, e.g. 0.2
  • plan_deductible_met — number

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• find_providers read-only

  Lists up to 5 facilities in one US state that perform a procedure, with name, address and a pricing_status field: 'observed' means a negotiated rate is published in that facility's price transparency data, 'estimated' means only a state-level benchmark applies, 'none' means no price data. Dollar amounts are not returned. The list is partial and is not a ranking or a recommendation.

  Parameters:

  • procedure (required) — string — Procedure slug or plain name, e.g. 'colonoscopy'
  • state (required) — string — 2-letter US state code, e.g. 'CT'
  • limit — integer — Max results, 1 to 5 (default 5)

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_provider read-only

  Public profile for a single provider by 10-digit NPI number: name, specialty, address, entity type.

  Parameters:

  • npi (required) — string — 10-digit NPI number

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• resolve_procedure read-only

  Maps a free-text procedure name ('knee mri', 'gallbladder removal') to a CostKits catalog slug with a confidence score. Returns best_match and alternatives; best_match is null when the procedure is not in the catalog.

  Parameters:

  • query (required) — string — Free-text procedure name

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_procedures read-only

  The full CostKits catalog: 30 procedures with slugs, display names, categories, and CPT codes (paginated).

  Parameters:

  • limit — integer
  • cursor — string — next_cursor from a previous response

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_procedure_details read-only

  Structured knowledge about one procedure. aspect='facts' returns LLM-ready billing rules and cost drivers (best for grounding an answer); 'bundle' explains which separate bills to expect (facility, physician, anesthesia...); 'full' returns the complete ontology.

  Parameters:

  • slug (required) — string — Canonical procedure slug, e.g. 'colonoscopy'
  • aspect — string — Default 'facts'

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_coverage read-only

  Insurance coverage rules for a procedure/carrier combination. aspect: 'summary' (status + plain English), 'prior-auth', 'cost-sharing' (deductible/coinsurance/ACA preventive), 'frequency' (how often covered, age rules), or 'triggers' (Pro plan: billing events that flip a $0 preventive claim to diagnostic — the highest-signal aspect).

  Parameters:

  • procedure (required) — string — Procedure slug, e.g. 'colonoscopy'
  • carrier (required) — string — Carrier key, e.g. 'aetna', 'cigna', 'bcbs', 'medicare' — see list_carriers
  • aspect — string — Default 'summary'
  • plan_type — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_carriers read-only

  All insurance carrier keys supported by the coverage tools (aetna, cigna, bcbs, medicare, ...). Works on the Free plan — also a good API-key sanity check.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• compare_bill_amount read-only

  Compares one dollar amount from a medical bill or explanation of benefits with the typical allowed-amount range (low, median, high) for the same procedure in the same US state, and says whether it is below, within or above that range, with questions worth asking the billing office. Pass amount_type 'billed' for the charge on the bill or 'allowed' for the insurer's allowed amount. Billed charges are usually higher than allowed amounts, so a high billed charge alone is not an error. Needs only the procedure, state and amount; do not send names, dates, account or member numbers.

  Parameters:

  • procedure (required) — string — Procedure slug or plain name, e.g. 'colonoscopy'. Resolve plain names with resolve_procedure.
  • state (required) — string — 2-letter US state code, e.g. 'TX'
  • amount (required) — number — The dollar amount from the bill or EOB
  • amount_type (required) — string — 'billed' = the charge on the bill; 'allowed' = the amount the insurer allowed

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• check_financial_assistance read-only

  Screen a household for hospital financial assistance (charity care): returns income as a percent of the federal poverty guidelines, the typical range hospital policies cover, what federal rules (IRS 501(r)) do and do not guarantee, and next steps. Use when a user asks whether they might qualify for help paying a hospital bill. It is a screening estimate, not an eligibility decision: each hospital sets its own limits. Needs household size and annual household income; do not ask for names, account numbers or bill details.

  Parameters:

  • household_size (required) — integer — Number of people in the household, including the patient
  • annual_household_income (required) — number — Total annual household income before taxes, in dollars
  • state — string — 2-letter US state code; only Alaska and Hawaii change the poverty guideline

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.