naftiko: 1.0.0-alpha2
info:
  label: Red5 Live Streaming Management
  description: Unified capability for managing live streaming infrastructure on Red5 Pro. Combines the Server API for node-level
    stream monitoring and control with the Stream Manager 2.0 API for autoscaled cluster orchestration. Used by streaming
    operations teams to monitor live events, manage stream quality, control recording, and scale streaming capacity.
  tags:
  - Live Streaming
  - Media
  - Real-Time
  - Red5
  - Streaming
  created: '2026-05-02'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    RED5_ACCESS_TOKEN: RED5_ACCESS_TOKEN
    RED5_SERVER_HOST: RED5_SERVER_HOST
capability:
  consumes:
  - type: http
    namespace: red5-server
    baseUri: http://{{RED5_SERVER_HOST}}:5080/api/v1
    description: Red5 Pro Server REST API for server and stream management
    authentication:
      type: apikey
      key: accessToken
      value: '{{RED5_ACCESS_TOKEN}}'
      placement: query
    resources:
    - name: server
      path: /server
      description: Server health and information
      operations:
      - name: get-server-info
        method: GET
        description: Get server version and info
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: ping-server
        method: GET
        description: Ping the server for health check
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: applications
      path: /applications
      description: Application scope management
      operations:
      - name: list-applications
        method: GET
        description: List all deployed applications
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: application
      path: /applications/{appName}
      description: Individual application management
      operations:
      - name: get-application
        method: GET
        description: Get application statistics
        inputParameters:
        - name: appName
          in: path
          type: string
          required: true
          description: Application scope name
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: streams
      path: /applications/{appName}/streams
      description: Live stream enumeration
      operations:
      - name: list-streams
        method: GET
        description: List active streams in an application
        inputParameters:
        - name: appName
          in: path
          type: string
          required: true
          description: Application scope name
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: stream
      path: /applications/{appName}/streams/{streamName}
      description: Individual stream management
      operations:
      - name: get-stream
        method: GET
        description: Get stream statistics and details
        inputParameters:
        - name: appName
          in: path
          type: string
          required: true
          description: Application scope name
        - name: streamName
          in: path
          type: string
          required: true
          description: Stream name
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: start-record
      path: /applications/{appName}/streams/{streamName}/action/startrecord
      description: Start stream recording
      operations:
      - name: start-recording
        method: POST
        description: Start recording a live stream
        inputParameters:
        - name: appName
          in: path
          type: string
          required: true
          description: Application scope name
        - name: streamName
          in: path
          type: string
          required: true
          description: Stream name
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: stop-record
      path: /applications/{appName}/streams/{streamName}/action/stoprecord
      description: Stop stream recording
      operations:
      - name: stop-recording
        method: POST
        description: Stop recording a live stream
        inputParameters:
        - name: appName
          in: path
          type: string
          required: true
          description: Application scope name
        - name: streamName
          in: path
          type: string
          required: true
          description: Stream name
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: red5-streaming-rest
    description: Unified REST API for Red5 live streaming management.
    resources:
    - path: /v1/server
      name: server
      description: Server health and information
      operations:
      - method: GET
        name: get-server-info
        description: Get server information and status
        call: red5-server.get-server-info
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/applications
      name: applications
      description: Streaming application management
      operations:
      - method: GET
        name: list-applications
        description: List deployed streaming applications
        call: red5-server.list-applications
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/applications/{app}/streams
      name: streams
      description: Live stream management
      operations:
      - method: GET
        name: list-streams
        description: List active streams in an application
        call: red5-server.list-streams
        with:
          appName: rest.app
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/applications/{app}/streams/{stream}
      name: stream
      description: Individual stream management
      operations:
      - method: GET
        name: get-stream
        description: Get stream statistics
        call: red5-server.get-stream
        with:
          appName: rest.app
          streamName: rest.stream
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/applications/{app}/streams/{stream}/record/start
      name: recording-start
      description: Start stream recording
      operations:
      - method: POST
        name: start-recording
        description: Start recording a stream
        call: red5-server.start-recording
        with:
          appName: rest.app
          streamName: rest.stream
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/applications/{app}/streams/{stream}/record/stop
      name: recording-stop
      description: Stop stream recording
      operations:
      - method: POST
        name: stop-recording
        description: Stop recording a stream
        call: red5-server.stop-recording
        with:
          appName: rest.app
          streamName: rest.stream
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9080
    namespace: red5-streaming-mcp
    transport: http
    description: MCP server for AI-assisted Red5 live streaming management.
    tools:
    - name: get-server-health
      description: Check Red5 Pro server health and get version information
      hints:
        readOnly: true
        openWorld: false
      call: red5-server.ping-server
      outputParameters:
      - type: object
        mapping: $.
    - name: get-server-info
      description: Get detailed Red5 Pro server configuration and status
      hints:
        readOnly: true
        openWorld: false
      call: red5-server.get-server-info
      outputParameters:
      - type: object
        mapping: $.
    - name: list-streaming-apps
      description: List all streaming applications deployed on the Red5 Pro server
      hints:
        readOnly: true
        openWorld: false
      call: red5-server.list-applications
      outputParameters:
      - type: object
        mapping: $.
    - name: get-app-stats
      description: Get statistics for a specific streaming application scope
      hints:
        readOnly: true
        openWorld: false
      call: red5-server.get-application
      with:
        appName: tools.app_name
      outputParameters:
      - type: object
        mapping: $.
    - name: list-live-streams
      description: List all active live streams in a streaming application
      hints:
        readOnly: true
        openWorld: false
      call: red5-server.list-streams
      with:
        appName: tools.app_name
      outputParameters:
      - type: object
        mapping: $.
    - name: get-stream-stats
      description: Get detailed statistics for a live stream including bitrate, frame rate, and subscriber count
      hints:
        readOnly: true
        openWorld: false
      call: red5-server.get-stream
      with:
        appName: tools.app_name
        streamName: tools.stream_name
      outputParameters:
      - type: object
        mapping: $.
    - name: start-stream-recording
      description: Start recording a live stream to disk storage
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: red5-server.start-recording
      with:
        appName: tools.app_name
        streamName: tools.stream_name
      outputParameters:
      - type: object
        mapping: $.
    - name: stop-stream-recording
      description: Stop an active stream recording and finalize the recording file
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: red5-server.stop-recording
      with:
        appName: tools.app_name
        streamName: tools.stream_name
      outputParameters:
      - type: object
        mapping: $.