Breaking Bad API — Episodes

naftiko: "1.0.0-alpha2"

info:
  label: "Breaking Bad API — Episodes"
  description: >-
    Episodes surface — Episodes. 2 operations. Lead operation: list every
    episode across Breaking Bad and Better Call Saul, optionally filtered by
    series. Self-contained Naftiko capability covering one Breaking Bad business
    surface. Note: upstream host (breakingbadapi.com) is deprecated and
    unreachable as of 2026-05-29; this capability is preserved for historical
    reference and for use against community mirrors or local re-implementations.
  tags:
    - Breaking Bad
    - Episodes
    - Television
  created: "2026-05-29"
  modified: "2026-05-29"

binds:
  - namespace: env
    keys:
      BREAKING_BAD_API_BASE: BREAKING_BAD_API_BASE

capability:

  consumes:
    - type: http
      namespace: "breaking-bad-episodes"
      baseUri: "https://www.breakingbadapi.com/api"
      description: "Breaking Bad API — Episodes business capability. Self-contained, no shared references."
      resources:
        - name: "episodes"
          path: "/episodes"
          operations:
            - name: "listEpisodes"
              method: GET
              description: "List every episode across both series, optionally filtered."
              inputParameters:
                - name: "series"
                  in: query
                  type: string
                  required: false
                  description: "Filter by series (Breaking+Bad or Better+Call+Saul)."
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: "$."
        - name: "episode-by-id"
          path: "/episodes/{id}"
          operations:
            - name: "getEpisodeById"
              method: GET
              description: "Retrieve a single episode by numeric id."
              inputParameters:
                - name: "id"
                  in: path
                  type: integer
                  required: true
                  description: "Numeric episode id."
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: "$."

  exposes:
    - type: rest
      namespace: "breaking-bad-episodes-rest"
      port: 8080
      description: "REST adapter for Breaking Bad API — Episodes."
      resources:
        - path: "/v1/episodes"
          name: "episodes"
          description: "REST surface for the episodes collection."
          operations:
            - method: GET
              name: "listEpisodes"
              description: "List episodes."
              call: "breaking-bad-episodes.listEpisodes"
              with:
                series: "rest.series"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: "/v1/episodes/{id}"
          name: "episode-by-id"
          description: "REST surface for a single episode."
          operations:
            - method: GET
              name: "getEpisodeById"
              description: "Get an episode by id."
              call: "breaking-bad-episodes.getEpisodeById"
              with:
                id: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      namespace: "breaking-bad-episodes-mcp"
      port: 9090
      transport: http
      description: "MCP adapter for Breaking Bad API — Episodes."
      tools:
        - name: "list-episodes"
          description: "List every episode across both series, optionally filtered by series."
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: "breaking-bad-episodes.listEpisodes"
          with:
            series: "tools.series"
          outputParameters:
            - type: object
              mapping: "$."
        - name: "get-episode"
          description: "Retrieve a single episode by id."
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: "breaking-bad-episodes.getEpisodeById"
          with:
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."