Costkits Mcp

io.github.costkits由 GitHub 帳號 costkits 發布v2.0.0更新於 Oct 27, 2026

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

已驗證Streamable HTTP可網頁執行位置與生活金融

概覽

AI 產生的概覽

託管型 MCP 伺服器,讓助理取得美國醫療處置費用估算、機構定價、保險給付規則與病患自付額計算。

可以做什麼
  • 把自由文字描述的處置名稱對應到目錄項目,並瀏覽含 CPT 代碼的 30 項處置目錄
  • 讀取處置的計費規則、費用驅動因素與可能出現的多張帳單
  • 依美國州別估算允許金額區間,並可一次呼叫串接處置、費用、機構與自付額
  • 依自負額、共保比例與自付上限計算病患應付金額
  • 尋找提供服務的機構,並依 NPI 查詢機構公開資料
  • 查詢保險給付規則與承保公司清單,並篩檢家庭是否符合醫院醫療補助資格
適用情境
適合使用者詢問美國某項檢查或手術要花多少錢、在特定保險方案下自己要付多少、是否需要事前授權,或某張帳單金額是否合理時使用。它以價格透明與 CMS 資料支撐回答,而非依賴模型記憶。
執行需求
可使用 mcp.costkits.com 的遠端端點,或透過 npx 執行 npm 套件作為轉送至託管伺服器的薄包裝。一般使用不需 API 金鑰或註冊;README 列出本機開發用的選用伺服器端變數(COSTKITS_MCP_URL、COSTKITS_API_KEY、COSTKITS_API_BASE、RATE_LIMIT_PER_MIN)。需要網路連線。
安裝前請注意
估算僅限美國,依據公開的價格透明與 CMS 資料,屬區間而非報價。不要傳送病患姓名、會員號、出生日期或病歷識別碼;README 表示請求紀錄不含自由文字。此伺服器不提供帳單分析,部分給付規則細節僅限付費方案。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Costkits Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.costkits%2Fcostkits-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "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

來源:README.md,提交 ff362a9

工具

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.

無需輸入參數。

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.

輸入參數state必填zip_codeplan_typeprocedure必填oop_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).

輸入參數copayoop_max必填oop_metdeductible必填coinsurance必填allowed_amount必填deductible_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.

輸入參數state必填fieldsprocedure必填plan_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.

輸入參數limitstate必填procedure必填

get_provider

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

輸入參數npi必填

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.

輸入參數query必填

list_procedures

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

輸入參數limitcursor

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.

輸入參數slug必填aspect

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

輸入參數aspectcarrier必填plan_typeprocedure必填

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.

無需輸入參數。

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.

輸入參數state必填amount必填procedure必填amount_type必填

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.

輸入參數statehousehold_size必填annual_household_income必填

版本歷史

2
  1. v2.0.0最新Oct 16, 2026
  2. v1.0.8Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分