Chuck Norris Jokes API — Categories

naftiko: "1.0.0-alpha2"

info:
  label: "Chuck Norris Jokes API — Categories"
  description: >-
    Categories — list of supported joke categories used to constrain random
    selection. 1 operation. Lead operation: List Joke Categories.
    Self-contained Naftiko capability covering one chucknorris.io business
    surface.
  tags:
    - Chuck Norris
    - Categories
  created: "2026-05-30"
  modified: "2026-05-30"

binds: []

capability:
  consumes:
    - type: http
      namespace: chucknorris-io-categories
      baseUri: https://api.chucknorris.io
      description: chucknorris.io Categories business capability. Self-contained, no shared references.
      resources:
        - name: jokes-categories
          path: /jokes/categories
          operations:
            - name: listcategories
              method: GET
              description: Chuck Norris List the available joke categories.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
      authentication:
        type: none
  exposes:
    - type: rest
      namespace: chucknorris-io-categories-rest
      port: 8080
      description: REST adapter for chucknorris.io Categories. One Spectral-compliant resource per consumed operation, prefixed with /v1.
      resources:
        - path: /v1/jokes/categories
          name: jokes-categories
          description: REST surface for /jokes/categories.
          operations:
            - method: GET
              name: listcategories
              description: Chuck Norris List the available joke categories.
              call: chucknorris-io-categories.listcategories
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      namespace: chucknorris-io-categories-mcp
      port: 9090
      transport: http
      description: MCP adapter for chucknorris.io Categories. One tool per consumed operation, routed inline through this capability's consumes block.
      tools:
        - name: chucknorris-list-joke-categories
          description: Chuck Norris List the available joke categories.
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: chucknorris-io-categories.listcategories
          outputParameters:
            - type: object
              mapping: $.