# io.github.costkits/costkits-mcp

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

- name: io.github.costkits/costkits-mcp
- version: 2.0.0
- connection class: R0 (autonomous)
- trust: 97/100
- quality: 81/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.costkits%2Fcostkits-mcp
- tools: https://api.protogrid.dev/v1/servers/io.github.costkits%2Fcostkits-mcp/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

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


## Trust

- hygiene: 100
- liveness: 100
- freshness: 100
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-100% +updated-4d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 81/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 86 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 13 of 13 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: check_financial_assistance (idempotentHint); estimate_procedure_cost (idempotentHint); find_providers (idempotentHint); …
- pass `tools.token_cost`: about 2,704 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool history recorded for 3 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: deps.dev does not know @costkits/costkits-mcp@2.0.0

- tools: 13, about 2,704 tokens to load them all
- tool set hash: 1f214a66700a7bcc78be08b9af839e36
- tools last changed: 2026-10-19T15:49:37.587Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.costkits/costkits-mcp.svg)](https://protogrid.dev/servers/io.github.costkits/costkits-mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-19 `compare_bill_amount` added
  - 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.
- 2026-10-17 `list_carriers` changed (annotations)
- 2026-10-17 `get_coverage` changed (annotations)
- 2026-10-17 `get_procedure_details` changed (annotations)
- 2026-10-17 `list_procedures` changed (annotations)
- 2026-10-17 `resolve_procedure` changed (description, annotations) **meaning changed**
  - before: Fuzzy-match a free-text procedure name ('knee mri', 'gallbladder removal') to a canonical slug with confidence scores. Call this BEFORE estimate tools whenever the user's wording might not be an exact slug.
  - after: 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.
- 2026-10-17 `get_provider` changed (annotations)
- 2026-10-17 `find_providers` changed (description, inputSchema, annotations) **meaning changed**
  - before: Find healthcare providers for a procedure in a US state. Each provider has pricing_status: 'observed' (real negotiated rate from hospital transparency data — prefer these), 'estimated', or 'none'. Set cluster=true for city-level groups with lat/lng.
  - after: 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.
- 2026-10-17 `full_estimate` changed (annotations)
- 2026-10-17 `estimate_procedure_cost` changed (description, inputSchema, annotations) **meaning changed**
  - before: Estimate what a medical procedure costs in a US state: allowed-amount range (low/median/high), billing components, risk flags, and — if insurance details are given — the patient's expected out-of-pocket. Use resolve_procedure first if the user gave a free-text procedure name. Always present ranges, not single numbers, and cite the returned data_vintage.
  - after: 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.

Full history: https://api.protogrid.dev/v1/servers/io.github.costkits%2Fcostkits-mcp/changes

## Dependencies

- npm @costkits/costkits-mcp@2.0.0: unknown

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0.

## Remotes

- https://mcp.costkits.com/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

- npm @costkits/costkits-mcp@2.0.0

## Tools (13)

- `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).
- `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.
- `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.
- `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.
- `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.
- `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.
- `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.
- `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).
- `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.
- `get_provider`: Public profile for a single provider by 10-digit NPI number: name, specialty, address, entity type.
- `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.
- `list_procedures`: The full CostKits catalog: 30 procedures with slugs, display names, categories, and CPT codes (paginated).
- `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.