spa_search

Pack: medicaid-state-plans · 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/spa_search for the schema, then POST the same URL with its arguments for the data.

Search CMS Medicaid.gov Medicaid State Plan Amendments (SPAs) by state, topic, keyword and approval or effective date. Returns transmittal number (e.g. FL-25-0015), state, summary, approval and effective dates, topic tags and the approval-package link, newest approval first by default. Use for “which SPAs changed FQHC reimbursement in Florida”. Unknown state or topic returns the valid values. Then call spa_get for the document text.

Parameters

NameTypeRequiredDescription
statestringnoState name or 2-letter code (e.g. “Florida” or “FL”). Several can be given separated by ”|”.
topicstringnoThe publisher’s topic tag (e.g. “Reimbursement”, “Managed Care”). Unknown tags return near matches.
qstringnoKeywords matched against the amendment text and summary, or a transmittal number.
approval_fromstringnoEarliest approval date, YYYY-MM-DD or MM/DD/YYYY.
approval_tostringnoLatest approval date.
effective_fromstringnoEarliest effective date.
effective_tostringnoLatest effective date.
sortstringnoDefault approval_newest.
limitnumbernoRows per page, 1-100 (default 25).
pagenumbernoZero-based page number (default 0). Use total_pages / has_next from the response.

Example call

Arguments

{
  "state": "Florida",
  "q": "FQHC",
  "limit": 5
}

curl

curl -X POST https://gateway.pipeworx.io/medicaid-state-plans/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"spa_search","arguments":{"state":"Florida","q":"FQHC","limit":5}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('spa_search', {
  "state": "Florida",
  "q": "FQHC",
  "limit": 5
});

Response shape

FieldTypeDescription
foundboolean
countnumber
pagenumber
total_pagesnumber
has_nextboolean
filters_appliedobject
sortstring
amendmentsarray
sourcestring
notestring
Full JSON Schema
{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "count": {
      "type": "number"
    },
    "page": {
      "type": "number"
    },
    "total_pages": {
      "type": "number"
    },
    "has_next": {
      "type": "boolean"
    },
    "filters_applied": {
      "type": "object",
      "properties": {
        "state": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "q": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "sort": {
      "type": "string"
    },
    "amendments": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "transmittal_number": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "state_code": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "approval_date": {
            "type": "string"
          },
          "effective_date": {
            "type": "string"
          },
          "topics": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "documents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "title": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                }
              },
              "additionalProperties": true
            }
          }
        },
        "additionalProperties": true
      }
    },
    "source": {
      "type": "string"
    },
    "note": {
      "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-state-plans pack
{
  "mcpServers": {
    "medicaid-state-plans": {
      "url": "https://gateway.pipeworx.io/medicaid-state-plans/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build November 16, 2026