Log inSubmit server
Costkits MCP logo

Costkits MCP

Estimate US healthcare procedure costs, patient responsibility, provider prices, coverage rules, and possible billing issues through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Costkits MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "costkits-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@costkits/costkits-mcp"
      ],
      "env": {
        "COSTKITS_API_KEY": "YOUR_VALUE_HERE",
        "COSTKITS_API_BASE": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The costkits-mcp MCP server connects MCP clients to the CostKits API for US healthcare cost and coverage data. It resolves free-text procedures, estimates geographic pricing, calculates patient responsibility, finds providers, retrieves coverage rules, and analyzes billing items. Use it when an agent needs structured estimates based on hospital-transparency and CMS data rather than model memory. The server uses stdio transport and requires a CostKits API key for all tools except the connectivity demo.

Use cases

  • Estimate a procedure price by geography
  • Calculate patient responsibility from benefit inputs
  • Compare observed negotiated provider prices
  • Check coverage and prior-authorization rules
  • Flag possible duplicate or unbundled bill items

Key features

  • Procedure resolution from free text
  • Geographic cost estimates with ranges
  • Patient liability calculations
  • Provider pricing and NPI lookup
  • Coverage and CPT procedure data
  • Medical bill item analysis

Tools11

What Costkits MCP lets your agent do. Expand a tool for its parameters.

Self-reported~192 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

6/6 checks healthy over the last 41d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · @costkits/costkits-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads438Package downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Tools exposed11Callable tools this server registers over MCP.

How Costkits MCP works

What costkits-mcp MCP server does

The costkits-mcp MCP server exposes CostKits healthcare pricing and coverage operations to MCP-compatible AI clients. It is intended for questions about US procedure costs, patient out-of-pocket responsibility, provider pricing, insurance rules, and potential billing problems.

The service can translate informal descriptions such as a user’s description of a scan into a supported procedure, then use that procedure for pricing or coverage queries. It can also combine procedure, geographic cost, provider, and benefit information into a fuller estimate. Results may include estimate ranges, data sources, data vintage, and model version.

How it works

An MCP client sends a request to the local server over stdio. The server selects and calls the corresponding CostKits API operation, then returns structured data for the client to explain. API errors can include an agent_hint indicating a next tool or correction, such as resolving an unsupported procedure name before retrying an estimate.

The costkits-mcp MCP server uses CostKits data derived from hospital-transparency and CMS sources. Insurance calculations are performed by the API using inputs such as deductible balance, coinsurance, copay, and out-of-pocket information rather than being calculated by the language model.

Bill analysis accepts billing codes, descriptions, and amounts to identify possible duplicate, unbundled, or suspicious items. The documented workflow does not require patient names, member IDs, dates of birth, or medical-record identifiers.

Setup and configuration

Install the package from npm with the package name @costkits/costkits-mcp, or run it through npx. A typical Claude Desktop configuration starts the server with npx -y @costkits/costkits-mcp and supplies COSTKITS_API_KEY in the environment. Restart the client after changing its MCP configuration.

COSTKITS_API_KEY is needed for every tool except demo_estimate; keys are available from CostKits. COSTKITS_API_BASE is optional and defaults to https://api.costkits.com, allowing the API endpoint to be overridden for testing.

Local development requires Node.js 18 or later and npm. The repository includes a smoke command that starts the server and calls the demo tool over MCP stdio.

Tools and capabilities

The costkits-mcp MCP server provides these groups of operations:

  • demo_estimate checks connectivity with a sample estimate without an API key.
  • resolve_procedure, estimate_procedure_cost, calculate_liability, and full_estimate support procedure matching, geographic pricing, benefit calculations, and combined estimates.
  • find_providers searches providers with observed negotiated prices, while get_provider retrieves a provider by NPI.
  • list_procedures and get_procedure_details expose supported procedures, CPT codes, billing bundles, and procedure facts.
  • get_coverage returns prior-authorization, cost-sharing, frequency, and trigger rules; list_carriers returns supported carrier identifiers.
  • analyze_bill reviews line items for possible duplicate, unbundled, or suspicious charges.

Tool availability depends on the CostKits plan. The README identifies most operations as Builder tools, coverage triggers as Pro, and bill analysis as Pro.

Limitations and notes

This server provides healthcare cost and coverage data, not a substitute for a payer decision or provider-specific confirmation. Estimates depend on available geographic, provider, procedure, and benefit inputs. For bill analysis, send only the codes, descriptions, and amounts needed for the review; do not send protected health information.

The documented tested client setup is Claude Desktop, and the server uses MCP stdio transport. A public demo tool is available, but authenticated access is required for the remaining operations.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Costkits MCP

costkits-mcp is an MCP server that connects AI clients to the CostKits API for US healthcare cost data. Its main tools resolve procedures, estimate geographic prices, calculate patient responsibility, find providers, retrieve coverage rules, and analyze bills for possible duplicate or unbundled charges.

Install it through npm or run it with `npx -y @costkits/costkits-mcp`. For Claude Desktop, add an MCP entry that starts this command, provide `COSTKITS_API_KEY` in its environment, and restart the client.

Yes, costkits-mcp can be used with Cursor because it uses MCP stdio transport. Configure Cursor to launch the npm package as an MCP server and provide a CostKits API key for tools other than `demo_estimate`.

Yes, all tools except `demo_estimate` require `COSTKITS_API_KEY`. The demo tool can return a sample estimate and verify connectivity without authentication.

Yes, `analyze_bill` can flag possible duplicate, unbundled, or suspicious bill items. Provide billing codes, descriptions, and amounts only; the documented workflow does not require names, member IDs, dates of birth, or medical-record identifiers.

Related MCP servers

All in Biology & Bioinformatics All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewCostkits MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/costkits-mcp?style=directory)](https://allmcps.com/mcp/costkits-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/costkits-mcp"><img src="https://allmcps.com/api/badge/costkits-mcp?style=directory" alt="Costkits MCP on AllMCPs" /></a>