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

NameTypeRequiredDescription
datasetstringyesWhich service-use measure family.
statestringnoState name or two-letter code, e.g. “Alabama” or “AL”.
yearnumbernoYear 2018-2022.
monthstringnoMonth as YYYYMM or YYYY-MM, e.g. “202001”.
servicestringnoSubstring of the service type, e.g. “LARC”, “ED visits”, “Telehealth”, “Inpatient”.
conditionstringnoacute_care / behavioral_health only: condition filter, e.g. “Substance use disorder”, “COVID-19”.
limitnumbernoMax 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

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

Regenerated from source · build November 16, 2026