Costkits Mcp

io.github.costkitsPublished by GitHub account costkitsv2.0.0Updated Oct 27, 2026

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

VerifiedStreamable HTTPWeb executableLocation & LifestyleFinance

Overview

AI-generated overview

Hosted MCP server giving assistants US healthcare procedure cost estimates, provider pricing, insurance coverage rules and patient liability math.

What you can do
  • Resolve free-text procedure names and browse the 30-procedure catalog with CPT codes
  • Read procedure billing rules, cost drivers and expected separate bills
  • Estimate allowed-amount ranges by US state and chain procedure, cost, providers and liability in one call
  • Calculate patient responsibility from deductible, coinsurance and out-of-pocket maximum
  • Find facilities and look up provider profiles by NPI
  • Look up insurance coverage rules and carrier keys, and screen households for hospital financial assistance
When to use it
Useful when users ask what a US medical procedure costs, what they might owe under a given plan, whether a procedure needs prior authorization, or whether a bill amount looks reasonable. It grounds answers in transparency and CMS data instead of model memory.
Requirements
Remote endpoint at mcp.costkits.com, or the npm package run via npx as a thin shim to the hosted server. No API key or signup for normal use; the README lists optional server-side variables (COSTKITS_MCP_URL, COSTKITS_API_KEY, COSTKITS_API_BASE, RATE_LIMIT_PER_MIN) for local development. Network access required.
Before you install
Estimates are US-only and based on published transparency and CMS data, so they are ranges rather than quotes. Do not send patient names, member IDs, dates of birth or medical-record identifiers; the README says requests are logged without free text. Bill analysis is not available through this server, and some coverage aspects are limited to a paid plan.

Installation

In SourceWeft

  1. Open Costkits Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.costkits%2Fcostkits-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "costkits": {
      "type": "http",
      "url": "https://mcp.costkits.com/mcp"
    }
  }
}

README

CostKits MCP Server

Give Claude, ChatGPT, Cursor, and other MCP clients access to live US healthcare cost data.

CostKits provides procedure cost estimates, patient out-of-pocket calculations, provider pricing, and insurance coverage rules using hospital-transparency and CMS data rather than model memory.

Ask healthcare cost questions in natural language. CostKits supplies the structured data and calculations.

[npm] [MCP] [MCP Registry] [smithery badge] [Glama] [License: MIT]

A hosted Model Context Protocol server. No API key, no signup. It powers the CostKits app in ChatGPT and works with any MCP client that supports remote servers.

What can an agent do with CostKits?

Ask questions such as:

  • "What would a colonoscopy cost in Connecticut?"
  • "How much would I owe if I have $500 left on my deductible and 20% coinsurance?"
  • "Compare MRI prices from providers near Dallas."
  • "Does this procedure commonly require prior authorization?"
  • "Resolve 'knee scan' to the correct procedure and estimate the cost."

The MCP server selects the appropriate CostKits API tools and returns structured healthcare cost data the model can explain to the user.

text
User question    ↓MCP client    ↓CostKits MCP tool    ↓CostKits healthcare cost API    ↓Structured estimate, provider pricing, coverage rule, or bill-analysis result

Connect

Remote (recommended): add the server URL in any client that supports remote MCP servers (ChatGPT, Claude, Cursor, and others):

text
https://mcp.costkits.com/mcp

Claude Desktop via npm: the package is a thin shim that forwards to the hosted server.

json
{  "mcpServers": {    "costkits": {      "command": "npx",      "args": ["-y", "@costkits/costkits-mcp"]    }  }}

Available tools

ToolWhat it does
resolve_procedureMatch a plain-language procedure name to a supported procedure
list_proceduresThe procedure catalog with CPT codes
get_procedure_detailsBilling rules, cost drivers, and which separate bills to expect
estimate_procedure_costCost range in a state, with expected out-of-pocket if you give plan details
full_estimateProcedure, cost, providers, and liability in one call
calculate_liabilityDeductible, coinsurance, and out-of-pocket math for a dollar amount
find_providersProviders with observed hospital-transparency prices (up to 10 per call)
get_providerPublic profile for one provider by NPI
get_coveragePrior auth, cost-sharing, and frequency rules by carrier
list_carriersSupported insurance carriers
demo_estimateSample estimate, for checking your connection

For bill review, use the CostKits app. Bill analysis is not available through this server.

Privacy and data handling

These tools do not need patient names, member IDs, dates of birth, or medical-record identifiers, and you should not send them. Requests are logged without free text, only the tool, procedure, and state.

Local development

bash
npm installnpm run start:http   # hosted server on :8787, set COSTKITS_API_KEY for a server-side keynpm run smoke        # stdio shim against a local hosted servernpm run smoke:http   # hosted server contract
Env varUsed byPurpose
COSTKITS_MCP_URLstdio shimOverride the hosted URL (default https://mcp.costkits.com/mcp)
COSTKITS_API_KEYhosted serverServer-side key for the CostKits backend
COSTKITS_API_BASEhosted serverBackend base URL
RATE_LIMIT_PER_MINhosted serverPer-IP limit (default 60)

Links

costkits.com · Interactive demo

About CostKits

CostKits is a healthcare cost-transparency platform built by John Caruso, FSA, MAAA, a healthcare actuary with more than 20 years of experience in insurance pricing, medical billing systems, and healthcare cost analytics.

This MCP server gives AI assistants and agents access to CostKits cost data.

Methodology

License

MIT

Source: README.md at commit ff362a9

Tools

13

demo_estimate

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.

Takes no parameters.

estimate_procedure_cost

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.

Parametersstaterequiredzip_codeplan_typeprocedurerequiredoop_remainingcoinsurance_pctdeductible_remaining

calculate_liability

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).

Parameterscopayoop_maxrequiredoop_metdeductiblerequiredcoinsurancerequiredallowed_amountrequireddeductible_metpreventive_exception

full_estimate

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.

Parametersstaterequiredfieldsprocedurerequiredplan_oop_maxplan_oop_metplan_deductibleplan_coinsuranceplan_deductible_met

find_providers

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.

Parameterslimitstaterequiredprocedurerequired

get_provider

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

Parametersnpirequired

resolve_procedure

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.

Parametersqueryrequired

list_procedures

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

Parameterslimitcursor

get_procedure_details

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.

Parametersslugrequiredaspect

get_coverage

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).

Parametersaspectcarrierrequiredplan_typeprocedurerequired

list_carriers

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.

Takes no parameters.

compare_bill_amount

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.

Parametersstaterequiredamountrequiredprocedurerequiredamount_typerequired

check_financial_assistance

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.

Parametersstatehousehold_sizerequiredannual_household_incomerequired

Version history

2
  1. v2.0.0LatestOct 16, 2026
  2. v1.0.8Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts