Amazon Kinesis Data Streams API — Consumers

naftiko: 1.0.0-alpha2
info:
  label: Amazon Kinesis Data Streams API — Consumers
  description: 'Amazon Kinesis Data Streams API — Consumers. 5 operations. Lead operation: Amazon Kinesis Deregister a stream
    consumer. Self-contained Naftiko capability covering one Amazon Kinesis business surface.'
  tags:
  - Amazon Kinesis
  - Consumers
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    AMAZON_KINESIS_API_KEY: AMAZON_KINESIS_API_KEY
capability:
  consumes:
  - type: http
    namespace: data-streams-consumers
    baseUri: https://kinesis.{region}.amazonaws.com
    description: Amazon Kinesis Data Streams API — Consumers business capability. Self-contained, no shared references.
    resources:
    - name: '#X-Amz-Target=Kinesis_20131202.DeregisterStreamConsumer'
      path: /#X-Amz-Target=Kinesis_20131202.DeregisterStreamConsumer
      operations:
      - name: deregisterstreamconsumer
        method: POST
        description: Amazon Kinesis Deregister a stream consumer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: '#X-Amz-Target=Kinesis_20131202.DescribeStreamConsumer'
      path: /#X-Amz-Target=Kinesis_20131202.DescribeStreamConsumer
      operations:
      - name: describestreamconsumer
        method: POST
        description: Amazon Kinesis Describe a stream consumer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: '#X-Amz-Target=Kinesis_20131202.ListStreamConsumers'
      path: /#X-Amz-Target=Kinesis_20131202.ListStreamConsumers
      operations:
      - name: liststreamconsumers
        method: POST
        description: Amazon Kinesis List stream consumers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: '#X-Amz-Target=Kinesis_20131202.RegisterStreamConsumer'
      path: /#X-Amz-Target=Kinesis_20131202.RegisterStreamConsumer
      operations:
      - name: registerstreamconsumer
        method: POST
        description: Amazon Kinesis Register a stream consumer for enhanced fan-out
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: '#X-Amz-Target=Kinesis_20131202.SubscribeToShard'
      path: /#X-Amz-Target=Kinesis_20131202.SubscribeToShard
      operations:
      - name: subscribetoshard
        method: POST
        description: Amazon Kinesis Subscribe to a shard for enhanced fan-out
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: apikey
      key: Authorization
      value: '{{env.AMAZON_KINESIS_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: data-streams-consumers-rest
    port: 8080
    description: REST adapter for Amazon Kinesis Data Streams API — Consumers. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/x-amz-target-kinesis-20131202-deregisterstreamconsumer
      name: x-amz-target-kinesis-20131202-deregisterstreamconsumer
      description: 'REST surface for #X-Amz-Target=Kinesis_20131202.DeregisterStreamConsumer.'
      operations:
      - method: POST
        name: deregisterstreamconsumer
        description: Amazon Kinesis Deregister a stream consumer
        call: data-streams-consumers.deregisterstreamconsumer
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/x-amz-target-kinesis-20131202-describestreamconsumer
      name: x-amz-target-kinesis-20131202-describestreamconsumer
      description: 'REST surface for #X-Amz-Target=Kinesis_20131202.DescribeStreamConsumer.'
      operations:
      - method: POST
        name: describestreamconsumer
        description: Amazon Kinesis Describe a stream consumer
        call: data-streams-consumers.describestreamconsumer
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/x-amz-target-kinesis-20131202-liststreamconsumers
      name: x-amz-target-kinesis-20131202-liststreamconsumers
      description: 'REST surface for #X-Amz-Target=Kinesis_20131202.ListStreamConsumers.'
      operations:
      - method: POST
        name: liststreamconsumers
        description: Amazon Kinesis List stream consumers
        call: data-streams-consumers.liststreamconsumers
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/x-amz-target-kinesis-20131202-registerstreamconsumer
      name: x-amz-target-kinesis-20131202-registerstreamconsumer
      description: 'REST surface for #X-Amz-Target=Kinesis_20131202.RegisterStreamConsumer.'
      operations:
      - method: POST
        name: registerstreamconsumer
        description: Amazon Kinesis Register a stream consumer for enhanced fan-out
        call: data-streams-consumers.registerstreamconsumer
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/x-amz-target-kinesis-20131202-subscribetoshard
      name: x-amz-target-kinesis-20131202-subscribetoshard
      description: 'REST surface for #X-Amz-Target=Kinesis_20131202.SubscribeToShard.'
      operations:
      - method: POST
        name: subscribetoshard
        description: Amazon Kinesis Subscribe to a shard for enhanced fan-out
        call: data-streams-consumers.subscribetoshard
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: data-streams-consumers-mcp
    port: 9090
    transport: http
    description: MCP adapter for Amazon Kinesis Data Streams API — Consumers. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: amazon-kinesis-deregister-stream-consumer
      description: Amazon Kinesis Deregister a stream consumer
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: data-streams-consumers.deregisterstreamconsumer
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: amazon-kinesis-describe-stream-consumer
      description: Amazon Kinesis Describe a stream consumer
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: data-streams-consumers.describestreamconsumer
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: amazon-kinesis-list-stream-consumers
      description: Amazon Kinesis List stream consumers
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: data-streams-consumers.liststreamconsumers
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: amazon-kinesis-register-stream-consumer
      description: Amazon Kinesis Register a stream consumer for enhanced fan-out
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: data-streams-consumers.registerstreamconsumer
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: amazon-kinesis-subscribe-shard-enhanced
      description: Amazon Kinesis Subscribe to a shard for enhanced fan-out
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: data-streams-consumers.subscribetoshard
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.