medicaid_service_use_monthly
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_monthly for the schema, then POST the same URL with its arguments for the data.
Monthly state service-use measures from CMS T-MSIS data, 2018-2022: blood lead screening of ages 1-2 (“blood_lead”), contraceptive care ages 15-44 incl. LARC (“contraceptive”), acute care - ED visits, inpatient and ICU stays (“acute_care”), and behavioral health services for mental health or SUD (“behavioral_health”). Returns service count and rate per 1,000 beneficiaries by state and month. Source: CMS, Medicaid and CHIP Scorecard.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
dataset | string | yes | Which service-use measure family. |
state | string | no | State name or two-letter code, e.g. “Alabama” or “AL”. |
year | number | no | Year 2018-2022. |
month | string | no | Month as YYYYMM or YYYY-MM, e.g. “202001”. |
service | string | no | Substring of the service type, e.g. “LARC”, “ED visits”, “Telehealth”, “Inpatient”. |
condition | string | no | acute_care / behavioral_health only: condition filter, e.g. “Substance use disorder”, “COVID-19”. |
limit | number | no | Max rows (default 100, max 500). |
Example call
Arguments
{
"dataset": "behavioral_health",
"state": "AL",
"year": 2022,
"service": "Telehealth",
"condition": "Mental health",
"limit": 12
}
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_monthly","arguments":{"dataset":"behavioral_health","state":"AL","year":2022,"service":"Telehealth","condition":"Mental health","limit":12}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('medicaid_service_use_monthly', {
"dataset": "behavioral_health",
"state": "AL",
"year": 2022,
"service": "Telehealth",
"condition": "Mental health",
"limit": 12
});
Response shape
| Field | Type | Description |
|---|---|---|
dataset | string | |
title | string | |
rate_unit | string | |
total | number | |
returned | number | |
rows | array | |
source | string | |
data_as_of | string |
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": {
"state": {
"type": "string"
},
"year": {
"type": "string"
},
"month": {
"type": "string"
},
"service": {
"type": "string"
},
"condition": {
"type": "string"
},
"service_count": {
"type": "number"
},
"rate_per_1000_beneficiaries": {
"type": "number"
},
"data_quality": {
"type": "null"
}
},
"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.