Manage Openlaw Capability

naftiko: "1.0.0-alpha2"

info:
  title: Manage OpenLaw
  description: >
    Searches the OpenLaws Legal Data API (https://api.openlaws.us) for artificial
    intelligence legislation across all 50 U.S. state jurisdictions. One consume
    namespace per state — each pre-scoped to its jurisdiction_key (AL, AK, AZ, ...)
    and pre-loaded with an AI-legislation keyword query. An aggregator tool fans
    the 50 searches out in parallel so a single MCP call or HTTP request returns
    a 50-state snapshot of statutes, rules, regulations, and constitutional
    provisions touching AI. Exposes both an MCP server (for Claude, GPT, and
    other agent runtimes) and a REST API (for humans, dashboards, CI jobs).

    Upstream API: https://docs.openlaws.us/guide/openlaws-legal-data-api
    OpenAPI source: all/openlaws/openapi/openlaws-openapi.yml
    Auth: bearer JWT (OPENLAWS_TOKEN)
    Search endpoint shape: GET /api/v1/jurisdictions/{jurisdiction_key}/laws/search
    Query params: query, type (or|and|phrase), with_federal, limit, page

capability:
  consumes:
    - namespace: openlaws-al
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Alabama (AL)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/AL/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Alabama (AL)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-ak
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Alaska (AK)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/AK/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Alaska (AK)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-az
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Arizona (AZ)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/AZ/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Arizona (AZ)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-ar
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Arkansas (AR)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/AR/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Arkansas (AR)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-ca
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to California (CA)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/CA/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in California (CA)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-co
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Colorado (CO)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/CO/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Colorado (CO)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-ct
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Connecticut (CT)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/CT/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Connecticut (CT)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-de
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Delaware (DE)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/DE/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Delaware (DE)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-fl
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Florida (FL)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/FL/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Florida (FL)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-ga
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Georgia (GA)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/GA/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Georgia (GA)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-hi
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Hawaii (HI)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/HI/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Hawaii (HI)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-id
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Idaho (ID)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/ID/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Idaho (ID)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-il
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Illinois (IL)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/IL/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Illinois (IL)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-in
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Indiana (IN)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/IN/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Indiana (IN)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-ia
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Iowa (IA)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/IA/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Iowa (IA)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-ks
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Kansas (KS)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/KS/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Kansas (KS)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-ky
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Kentucky (KY)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/KY/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Kentucky (KY)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-la
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Louisiana (LA)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/LA/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Louisiana (LA)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-me
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Maine (ME)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/ME/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Maine (ME)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-md
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Maryland (MD)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/MD/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Maryland (MD)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-ma
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Massachusetts (MA)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/MA/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Massachusetts (MA)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-mi
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Michigan (MI)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/MI/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Michigan (MI)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-mn
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Minnesota (MN)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/MN/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Minnesota (MN)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-ms
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Mississippi (MS)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/MS/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Mississippi (MS)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-mo
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Missouri (MO)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/MO/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Missouri (MO)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-mt
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Montana (MT)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/MT/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Montana (MT)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-ne
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Nebraska (NE)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/NE/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Nebraska (NE)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-nv
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to Nevada (NV)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/NV/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in Nevada (NV)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-nh
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to New Hampshire (NH)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/NH/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in New Hampshire (NH)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-nj
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to New Jersey (NJ)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/NJ/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in New Jersey (NJ)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: openlaws-nm
      type: http
      baseUri: "https://api.openlaws.us"
      description: "OpenLaws keyword search scoped to New Mexico (NM)."
      authentication:
        type: bearer
        token: "{{OPENLAWS_TOKEN}}"
      resources:
        - name: laws-search
          path: "/api/v1/jurisdictions/NM/laws/search"
          operations:
            - name: search-ai-legislation
              method: GET
              description: "Keyword search for AI-related laws in New Mexico (NM)."
              inputParameters:
                - name: query
                  in: query
                  value: "artificial intelligence"
                - name: type
                  in: query
                  value: "phrase"
                - name: with_federal
                  in: query
                  required: false
                - name: limit
                  in: query
                  required: false
                - name: page
                  in: query
                  required: false

    - namespace: o

# --- truncated at 32 KB (127 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/naftiko/refs/heads/main/capabilities/manage-openlaw-capability.yaml