medicaid_service_use_annual

Pack: medicaid-quality · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/medicaid_service_use_annual for the schema, then POST the same URL with its arguments for the data.

Annual service-use measures built from CMS T-MSIS (Transformed Medicaid Statistical Information System) data: share of Medicaid and CHIP enrollees with a well-child visit (dataset “well_child”), receiving mental health or substance-use-disorder services (“mental_health_sud”), and preterm births and severe maternal morbidity among Medicaid/CHIP-covered live births, by state (“prematurity_smm”). Years 2020-2022. Breaks out by age, race/ethnicity, program type etc. Source: CMS, Medicaid and CHIP Scorecard.

Parameters

NameTypeRequiredDescription
datasetstringyesWhich service-use measure family.
yearnumbernoYear (2020, 2021 or 2022).
geographystringnoState name/code or “National”. The well_child and mental_health_sud datasets are national only; prematurity_smm is by state.
categorystringnoSubstring of the measure category, e.g. “preterm”, “SMM”, “SUD”.
subpopulation_topicstringnoBreakout dimension, e.g. “Age group”, “Race and ethnicity”, “Total enrollees”.
limitnumbernoMax rows (default 100, max 500).

Example call

Arguments

{
  "dataset": "prematurity_smm",
  "geography": "AL",
  "category": "preterm"
}

curl

curl -X POST https://gateway.pipeworx.io/medicaid-quality/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"medicaid_service_use_annual","arguments":{"dataset":"prematurity_smm","geography":"AL","category":"preterm"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('medicaid_service_use_annual', {
  "dataset": "prematurity_smm",
  "geography": "AL",
  "category": "preterm"
});

Response shape

FieldTypeDescription
datasetstring
titlestring
rate_unitstring
totalnumber
returnednumber
rowsarray
sourcestring
data_as_ofstring
Full JSON Schema
{
  "type": "object",
  "properties": {
    "dataset": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "rate_unit": {
      "type": "string"
    },
    "total": {
      "type": "number"
    },
    "returned": {
      "type": "number"
    },
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "year": {
            "type": "string"
          },
          "geography": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "subpopulation_topic": {
            "type": "string"
          },
          "subpopulation": {
            "type": "string"
          },
          "count": {
            "type": "number"
          },
          "denominator": {
            "type": "number"
          },
          "rate": {
            "type": "number"
          },
          "data_version": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "source": {
      "type": "string"
    },
    "data_as_of": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}
Connect to just the medicaid-quality pack
{
  "mcpServers": {
    "medicaid-quality": {
      "url": "https://gateway.pipeworx.io/medicaid-quality/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build November 16, 2026