ZoningVerdict

Free coverage preflight for an address or municipality string. Returns whether ZoningVerdict covers it, its automatic/manual/unreliable resolve grade, available topics, pack version, and last-reviewed date. It does not identify a parcel's zoning district; use resolve_parcel_district only when the district determination is needed and the grade is not unreliable. Results are for information purposes only.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Address or municipality string."
    },
    "address": {
      "type": "string",
      "description": "Street address text; city and state improve matching."
    },
    "municipality": {
      "type": "string",
      "description": "Municipality slug or name."
    }
  }
}

List the municipalities ZoningVerdict covers, with each pack's version, last-reviewed date, and resolve grade. Coverage is reviewed summaries of public zoning ordinances, for information purposes only. Start here when you do not have a street address; with an address, start with check_coverage.

{
  "type": "object",
  "properties": {}
}

List the zoning district codes for one municipality, with each district's name, category, and summary. Use these codes with get_district_rules; do not guess codes. If you have a street address, resolve_parcel_district identifies the district for you. Free, like list_municipalities. Reviewed summaries for information purposes only.

{
  "type": "object",
  "properties": {
    "municipality": {
      "type": "string",
      "description": "Municipality slug from list_municipalities."
    }
  },
  "required": [
    "municipality"
  ]
}

Get the published rules for one zoning district by topic (setbacks, fences, accessory structures, and so on). District codes come from list_districts or resolve_parcel_district — do not guess them. Every rule carries its ordinance citation and source link plus the pack's last-reviewed date. Summaries for information, not legal advice; confirm with the municipality before acting.

{
  "type": "object",
  "properties": {
    "municipality": {
      "type": "string",
      "description": "Municipality slug from list_municipalities."
    },
    "district": {
      "type": "string",
      "description": "District code, e.g. R-2. Get valid codes from list_districts or resolve_parcel_district; do not guess."
    },
    "topic": {
      "type": "string",
      "description": "One of: permitted_uses, special_land_uses, setbacks, height, lot_coverage, lot_size, parking, adu, accessory_structures, fences, signs, home_occupation, variance_process."
    }
  },
  "required": [
    "municipality"
  ]
}

Look up a published question-and-answer for a municipality and topic. Returns the matching reviewed answer with its citations, or reports honestly that no published answer exists and lists the topics that do have reviewed answers. Never generates new answers; confirm with the municipality before acting.

{
  "type": "object",
  "properties": {
    "municipality": {
      "type": "string",
      "description": "Municipality slug from list_municipalities."
    },
    "topic": {
      "type": "string",
      "description": "Optional filter, one of: permitted_uses, special_land_uses, setbacks, height, lot_coverage, lot_size, parking, adu, accessory_structures, fences, signs, home_occupation, variance_process."
    },
    "query": {
      "type": "string",
      "description": "The question in plain words, used to find the best match."
    }
  },
  "required": [
    "municipality"
  ]
}

Resolve a street address to its municipality and, where a validated GIS path exists, its zoning district. Check coverage first; an unreliable municipality is refused before payment. When a district is returned, pass it to get_district_rules. The response discloses how the district was identified. Parcel boundaries and zoning lines can disagree near edges; confirm with the municipality before acting.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Street address, city, MI."
    }
  },
  "required": [
    "address"
  ]
}

Start a $49/month watch on a covered municipality (optionally one topic): an email whenever a human-reviewed rule change is published, with the citation and the updated page. Returns a Stripe checkout URL; the subscription activates only after checkout completes, and every email carries unsubscribe and billing links. Alerts are reviewed summaries for information purposes. Use list_municipalities for coverage.

{
  "type": "object",
  "properties": {
    "municipality": {
      "type": "string",
      "description": "Municipality slug from list_municipalities."
    },
    "topic": {
      "type": "string",
      "description": "Optional: watch one topic only, one of: permitted_uses, special_land_uses, setbacks, height, lot_coverage, lot_size, parking, adu, accessory_structures, fences, signs, home_occupation, variance_process."
    }
  },
  "required": [
    "municipality"
  ]
}

Issue a free-only API key without checkout or a wallet. Accept the current published terms and supply a cryptographically random 64-character hex client_nonce; retain it privately for safe retries. 100 successful metered calls per UTC month, shared across rules, questions and parcel resolve. One issuance per network egress per month; shared networks may hit this limit. Key expires at the next UTC month. No paid overages; $3 compiled Preflights and $1 monitoring remain x402-paid and are not included.

{
  "type": "object",
  "properties": {
    "client_nonce": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$",
      "description": "Generate 32 random bytes as lowercase hex; retain privately for retry. Never use a public example value."
    },
    "accept_terms": {
      "type": "boolean",
      "const": true
    },
    "terms_version": {
      "type": "string",
      "description": "Current terms version from /api/v1/openapi.json info.description or the issue response."
    }
  },
  "required": [
    "client_nonce",
    "accept_terms",
    "terms_version"
  ],
  "additionalProperties": false
}

Compile an address and structured project intent into a preliminary zoning verdict, cited conditions, approval path, versioned evidence and EdDSA JWS. $3 USDC on Base; pack_gap refusals are never charged. Paid Preflight coverage is narrower than address resolution. Durable workflow status and result retrieval included.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "minLength": 8,
      "maxLength": 500
    },
    "request_id": {
      "type": "string",
      "minLength": 32,
      "maxLength": 128,
      "description": "Fresh cryptographically random purchase ID. Retain for retry; never reuse for different input."
    },
    "intent": {
      "type": "object",
      "required": [
        "taxonomy_version",
        "project_type",
        "use",
        "attributes"
      ],
      "properties": {
        "taxonomy_version": {
          "const": 2
        },
        "project_type": {
          "enum": [
            "building_addition",
            "accessory_dwelling_unit",
            "detached_accessory_structure",
            "fence",
            "home_occupation",
            "use_conversion"
          ]
        },
        "use": {
          "type": "string"
        },
        "attributes": {
          "type": "object"
        }
      }
    }
  },
  "required": [
    "address",
    "request_id",
    "intent"
  ],
  "additionalProperties": false
}

Attach 30 days of optional Impact Updates to a purchased machine Preflight for $1 USDC via x402. Poll signed, versioned JSON updates using the original workflow access token. No automatic renewal.

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "type": "string"
    },
    "access_token": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "minLength": 32,
      "maxLength": 128
    }
  },
  "required": [
    "workflow_id",
    "access_token",
    "request_id"
  ],
  "additionalProperties": false
}

Poll signed Impact Updates for a purchased machine Preflight, with a version cursor. Free; requires the original workflow access token.

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "type": "string"
    },
    "access_token": {
      "type": "string"
    },
    "after_version": {
      "type": "integer",
      "minimum": 0
    }
  },
  "required": [
    "workflow_id",
    "access_token"
  ]
}

Retrieve durable machine Preflight status and, after settlement, its signed result. Free; requires workflow access token.

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "type": "string"
    },
    "access_token": {
      "type": "string"
    }
  },
  "required": [
    "workflow_id",
    "access_token"
  ]
}