{
  "name": "employer-benefits-mcp",
  "title": "HealthMesh · Employer Benefits (BLS National Compensation Survey) MCP",
  "version": "0.1.0",
  "description": "BLS National Compensation Survey employer benefits for healthcare workers' plans: access, participation and take-up for medical, dental, vision and prescription coverage; employer and employee premium shares and monthly premium amounts; deductibles and out-of-pocket maximums where BLS publishes them. Breaks by establishment size, industry, occupation, union status, region and wage percentile, March 2010 onward. Every figure is the BLS published value, with its series id, March reference period and standard error.",
  "healthmesh_domain": "Health Plans & Benefits",
  "datasets": [
    "PLAN-08"
  ],
  "mcp_endpoint": "https://employer-benefits.healthmesh.ai/mcp",
  "transport": "Streamable HTTP (stateless, JSON responses)",
  "authorization": "HealthMesh account required (Authorization: Bearer <API token hm_live_… or OAuth access token>); see oauth_protected_resource",
  "auth_mode": "gateway",
  "oauth_protected_resource": "https://employer-benefits.healthmesh.ai/.well-known/oauth-protected-resource",
  "docs": "https://github.com/HendrikK/healthmesh/tree/main/servers/employer-benefits-mcp#readme",
  "contact": "hendrik.kleine@gmail.com",
  "data_source": {
    "name": "BLS National Compensation Survey benefits flat files (NB), healthcare benefits, stored in R2",
    "url": "https://download.bls.gov/pub/time.series/nb/",
    "license": "Source: U.S. Bureau of Labor Statistics, National Compensation Survey. BLS.gov cannot vouch for the data or analyses derived from these data after the data have been retrieved from BLS.gov. HealthMesh is not affiliated with or endorsed by BLS. The BLS emblem is not used.",
    "refresh": "Annual, after BLS updates download.bls.gov/pub/time.series/nb/. pipeline/build.py then pipeline/publish.py. Weekly check compares Last-Modified."
  },
  "tools": [
    {
      "name": "ncs_lookup_benefit",
      "title": "Look up BLS benefit access, participation, or take-up",
      "description": "National Compensation Survey healthcare benefits from the stored NB flat files. Returns the BLS published value, series id, March reference period, and standard error. Benefit: medical, dental, vision, prescription_drug, healthcare, hsa, health_fsa, retiree_health_under_65, retiree_health_65_and_over, wellness, employee_assistance, long_term_care, paid_family_medical_leave, domestic_partner_health_same_sex, domestic_partner_health_opposite_sex; a 3-character BLS provision code; or text from the BLS provision or series title. measure is access, participation, or take_up; omit it to return every incidence measure BLS publishes for that benefit. ownership defaults to private. industry, occupation and characteristic are separate BLS breaks and cannot be combined. characteristic slugs include lt_50, size_500_plus, union, nonunion, full_time, part_time, northeast, south, midwest, west, and wage slugs lowest_10, lowest_25, p25_to_50, p50_to_75, highest_25, highest_10 (the wage distribution follows ownership). Pass series_id to return one BLS series exactly."
    },
    {
      "name": "ncs_lookup_cost",
      "title": "Look up BLS premium shares, premiums, deductibles, or out-of-pocket maximums",
      "description": "Premium shares and average flat monthly premiums (single and family; employer and employee), and the BLS medical-care-plans deductible and out-of-pocket maximum percentiles. Values, series ids, March reference periods, and standard errors are the BLS published figures. topic is premium_share, premium_amount, deductible, or out_of_pocket. coverage is single or family for premiums, and individual or family for deductibles and out-of-pocket maximums. payer is employer or employee. statistic for dollar amounts is p10, p25, median, p75, p90, or all. Omit topic and pass query to search other published provisions (for example high deductible) by BLS title. ownership defaults to private. industry, occupation and characteristic are separate BLS breaks and cannot be combined. characteristic slugs include lt_50, size_500_plus, union, nonunion, full_time, part_time, northeast, south, midwest, west, and wage slugs lowest_10, lowest_25, p25_to_50, p50_to_75, highest_25, highest_10 (the wage distribution follows ownership)."
    },
    {
      "name": "ncs_compare",
      "title": "Compare one BLS benefit or cost series across groups or years",
      "description": "One BLS series definition compared across establishment_size, region, census_division, union_status, work_status, wage_percentile, industry, occupation, ownership, or year. Each row's value and standard_error are the BLS published figures. healthmesh_difference subtracts the baseline BLS value from the row's BLS value and is labelled HealthMesh calculation. It is not a BLS estimate. Set include_difference to false to omit it. For a cost comparison set topic, coverage, payer, and statistic so they select one series. For a benefit comparison set benefit and measure."
    },
    {
      "name": "ncs_describe_dataset",
      "title": "Describe the stored National Compensation Survey benefits copy",
      "description": "Coverage, March reference years, file vintage, BLS terms, benefit slugs, cost topics, and the breaks ncs_compare can use. Values in this store are the BLS published strings. Pass provision_query to list matching BLS provision codes."
    }
  ]
}