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
| Name | Type | Required | Description |
|---|---|---|---|
query | string | yes | Topic or keywords in plain English, e.g. “use tax exemption solar energy devices”. |
title | string | no | Optional: restrict to one ARS title number, e.g. “42” (Taxation), “13” (Criminal Code), “33” (Property). |
limit | number | no | Max 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
| Field | Type | Description |
|---|---|---|
found | boolean | true when at least one section matched; false with reason no_match on a miss |
reason | string | null | Why found is false (no_match) |
message | string | null | Plain-English explanation of a miss |
query | string | null | The query as received |
terms_searched | array | null | Query words sent upstream after filler words were removed |
title | string | null | ARS title filter, or null |
count | integer | null | Number of results returned |
total_matched | integer | null | Number of sections the Legislature full-text search matched before ranking |
results | array | null | |
match_level | string | null | full_text |
ranking | string | null | How results were ranked |
hint | string | null | Next step for the caller |
source | string | null | Publisher and dataset |
data_as_of | string | null | ISO 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.