az_search

Pack: arizona-code · 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/az_search for the schema, then POST the same URL with its arguments for the data.

Find Arizona Revised Statutes sections BY TOPIC when you do not have a citation: “use tax exemption solar energy devices”, “landlord security deposit”, “driving under the influence”. Searches the full text of Arizona state law, then ranks sections by how well their own catchline fits the query. Returns candidate citations with catchlines (the answer is usually one of the first few); call az_revised_statute with a citation for the statutory text. Optional title filter (e.g. 42 for Taxation). Returns found:false with a reason on a miss, never an empty list. Keyless.

Parameters

NameTypeRequiredDescription
querystringyesTopic or keywords in plain English, e.g. “use tax exemption solar energy devices”.
titlestringnoOptional: restrict to one ARS title number, e.g. “42” (Taxation), “13” (Criminal Code), “33” (Property).
limitnumbernoMax results, default 10, max 25.

Example call

Arguments

{
  "query": "use tax exemption solar energy devices"
}

curl

curl -X POST https://gateway.pipeworx.io/arizona-code/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"az_search","arguments":{"query":"use tax exemption solar energy devices"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('az_search', {
  "query": "use tax exemption solar energy devices"
});

More examples

{
  "query": "driving under the influence",
  "title": "28",
  "limit": 5
}

Response shape

FieldTypeDescription
foundbooleantrue when at least one section matched; false with reason no_match on a miss
reasonstring | nullWhy found is false (no_match)
messagestring | nullPlain-English explanation of a miss
querystring | nullThe query as received
terms_searchedarray | nullQuery words sent upstream after filler words were removed
titlestring | nullARS title filter, or null
countinteger | nullNumber of results returned
total_matchedinteger | nullNumber of sections the Legislature full-text search matched before ranking
resultsarray | null
match_levelstring | nullfull_text
rankingstring | nullHow results were ranked
hintstring | nullNext step for the caller
sourcestring | nullPublisher and dataset
data_as_ofstring | nullISO timestamp of the upstream read
Full JSON Schema
{
  "type": "object",
  "additionalProperties": true,
  "properties": {
    "found": {
      "type": "boolean",
      "description": "true when at least one section matched; false with reason no_match on a miss"
    },
    "reason": {
      "type": [
        "string",
        "null"
      ],
      "description": "Why found is false (no_match)"
    },
    "message": {
      "type": [
        "string",
        "null"
      ],
      "description": "Plain-English explanation of a miss"
    },
    "query": {
      "type": [
        "string",
        "null"
      ],
      "description": "The query as received"
    },
    "terms_searched": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      },
      "description": "Query words sent upstream after filler words were removed"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "ARS title filter, or null"
    },
    "count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Number of results returned"
    },
    "total_matched": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Number of sections the Legislature full-text search matched before ranking"
    },
    "results": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "citation": {
            "type": [
              "string",
              "null"
            ],
            "description": "Citation, e.g. A.R.S. 42-5159"
          },
          "section": {
            "type": [
              "string",
              "null"
            ],
            "description": "Section number, e.g. 42-5159"
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "ARS title number"
          },
          "catchline": {
            "type": [
              "string",
              "null"
            ],
            "description": "The section heading"
          },
          "phrase_hits": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Upstream phrase-hit count for this section"
          },
          "catchline_terms_matched": {
            "type": [
              "integer",
              "null"
            ],
            "description": "How many query words appear in the catchline"
          },
          "matched_by": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "catchline and/or full_text"
          }
        }
      }
    },
    "match_level": {
      "type": [
        "string",
        "null"
      ],
      "description": "full_text"
    },
    "ranking": {
      "type": [
        "string",
        "null"
      ],
      "description": "How results were ranked"
    },
    "hint": {
      "type": [
        "string",
        "null"
      ],
      "description": "Next step for the caller"
    },
    "source": {
      "type": [
        "string",
        "null"
      ],
      "description": "Publisher and dataset"
    },
    "data_as_of": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO timestamp of the upstream read"
    }
  }
}

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 arizona-code pack
{
  "mcpServers": {
    "arizona-code": {
      "url": "https://gateway.pipeworx.io/arizona-code/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build November 21, 2026