AWS Fargate Amazon ECS API (Fargate)

naftiko: 1.0.0-alpha2
info:
  label: AWS Fargate Amazon ECS API (Fargate)
  description: The Amazon ECS API provides programmatic access to manage Fargate tasks and services through Amazon Elastic
    Container Service. AWS Fargate is a serverless compute engine for containers that removes the need to provision and manage
    servers. This specification covers the core ECS API operations relevant to Fargate workloads, including registering task
    definitions with Fargate compatibility, running tasks on Fargate infrastructure, and managing services with the Fargate
    launch type. All operations use the JSON-RPC style with POST requests and an X-Amz-Target header specifying the action.
  tags:
  - Fargate
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: fargate
    baseUri: https://ecs.us-east-1.amazonaws.com
    description: AWS Fargate Amazon ECS API (Fargate) HTTP API.
    authentication:
      type: apikey
      in: header
      name: Authorization
      value: '{{FARGATE_TOKEN}}'
    resources:
    - name: x-amz-target-amazonec2containerservicev20141113-
      path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.RegisterTaskDefinition
      operations:
      - name: registertaskdefinition
        method: POST
        description: AWS Fargate Register a Fargate task definition
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: x-amz-target-amazonec2containerservicev20141113-
      path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DescribeTaskDefinition
      operations:
      - name: describetaskdefinition
        method: POST
        description: AWS Fargate Describe a task definition
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: x-amz-target-amazonec2containerservicev20141113-
      path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.ListTaskDefinitions
      operations:
      - name: listtaskdefinitions
        method: POST
        description: AWS Fargate List task definitions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: x-amz-target-amazonec2containerservicev20141113-
      path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DeregisterTaskDefinition
      operations:
      - name: deregistertaskdefinition
        method: POST
        description: AWS Fargate Deregister a task definition
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: x-amz-target-amazonec2containerservicev20141113-
      path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.RunTask
      operations:
      - name: runtask
        method: POST
        description: AWS Fargate Run a Fargate task
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: x-amz-target-amazonec2containerservicev20141113-
      path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.StopTask
      operations:
      - name: stoptask
        method: POST
        description: AWS Fargate Stop a running task
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: x-amz-target-amazonec2containerservicev20141113-
      path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DescribeTasks
      operations:
      - name: describetasks
        method: POST
        description: AWS Fargate Describe one or more tasks
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: x-amz-target-amazonec2containerservicev20141113-
      path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.ListTasks
      operations:
      - name: listtasks
        method: POST
        description: AWS Fargate List tasks in a cluster
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: x-amz-target-amazonec2containerservicev20141113-
      path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.CreateService
      operations:
      - name: createservice
        method: POST
        description: AWS Fargate Create a Fargate service
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: x-amz-target-amazonec2containerservicev20141113-
      path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.UpdateService
      operations:
      - name: updateservice
        method: POST
        description: AWS Fargate Update a Fargate service
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: x-amz-target-amazonec2containerservicev20141113-
      path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DeleteService
      operations:
      - name: deleteservice
        method: POST
        description: AWS Fargate Delete a service
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: x-amz-target-amazonec2containerservicev20141113-
      path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DescribeServices
      operations:
      - name: describeservices
        method: POST
        description: AWS Fargate Describe one or more services
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: x-amz-target-amazonec2containerservicev20141113-
      path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.ListServices
      operations:
      - name: listservices
        method: POST
        description: AWS Fargate List services in a cluster
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: x-amz-target-amazonec2containerservicev20141113-
      path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.CreateCluster
      operations:
      - name: createcluster
        method: POST
        description: AWS Fargate Create an ECS cluster
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: x-amz-target-amazonec2containerservicev20141113-
      path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DescribeClusters
      operations:
      - name: describeclusters
        method: POST
        description: AWS Fargate Describe one or more clusters
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: x-amz-target-amazonec2containerservicev20141113-
      path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.ExecuteCommand
      operations:
      - name: executecommand
        method: POST
        description: AWS Fargate Execute a command in a Fargate task container
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: fargate-rest
    description: REST adapter for AWS Fargate Amazon ECS API (Fargate).
    resources:
    - path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.RegisterTaskDefinition
      name: registertaskdefinition
      operations:
      - method: POST
        name: registertaskdefinition
        description: AWS Fargate Register a Fargate task definition
        call: fargate.registertaskdefinition
        outputParameters:
        - type: object
          mapping: $.
    - path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DescribeTaskDefinition
      name: describetaskdefinition
      operations:
      - method: POST
        name: describetaskdefinition
        description: AWS Fargate Describe a task definition
        call: fargate.describetaskdefinition
        outputParameters:
        - type: object
          mapping: $.
    - path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.ListTaskDefinitions
      name: listtaskdefinitions
      operations:
      - method: POST
        name: listtaskdefinitions
        description: AWS Fargate List task definitions
        call: fargate.listtaskdefinitions
        outputParameters:
        - type: object
          mapping: $.
    - path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DeregisterTaskDefinition
      name: deregistertaskdefinition
      operations:
      - method: POST
        name: deregistertaskdefinition
        description: AWS Fargate Deregister a task definition
        call: fargate.deregistertaskdefinition
        outputParameters:
        - type: object
          mapping: $.
    - path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.RunTask
      name: runtask
      operations:
      - method: POST
        name: runtask
        description: AWS Fargate Run a Fargate task
        call: fargate.runtask
        outputParameters:
        - type: object
          mapping: $.
    - path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.StopTask
      name: stoptask
      operations:
      - method: POST
        name: stoptask
        description: AWS Fargate Stop a running task
        call: fargate.stoptask
        outputParameters:
        - type: object
          mapping: $.
    - path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DescribeTasks
      name: describetasks
      operations:
      - method: POST
        name: describetasks
        description: AWS Fargate Describe one or more tasks
        call: fargate.describetasks
        outputParameters:
        - type: object
          mapping: $.
    - path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.ListTasks
      name: listtasks
      operations:
      - method: POST
        name: listtasks
        description: AWS Fargate List tasks in a cluster
        call: fargate.listtasks
        outputParameters:
        - type: object
          mapping: $.
    - path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.CreateService
      name: createservice
      operations:
      - method: POST
        name: createservice
        description: AWS Fargate Create a Fargate service
        call: fargate.createservice
        outputParameters:
        - type: object
          mapping: $.
    - path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.UpdateService
      name: updateservice
      operations:
      - method: POST
        name: updateservice
        description: AWS Fargate Update a Fargate service
        call: fargate.updateservice
        outputParameters:
        - type: object
          mapping: $.
    - path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DeleteService
      name: deleteservice
      operations:
      - method: POST
        name: deleteservice
        description: AWS Fargate Delete a service
        call: fargate.deleteservice
        outputParameters:
        - type: object
          mapping: $.
    - path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DescribeServices
      name: describeservices
      operations:
      - method: POST
        name: describeservices
        description: AWS Fargate Describe one or more services
        call: fargate.describeservices
        outputParameters:
        - type: object
          mapping: $.
    - path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.ListServices
      name: listservices
      operations:
      - method: POST
        name: listservices
        description: AWS Fargate List services in a cluster
        call: fargate.listservices
        outputParameters:
        - type: object
          mapping: $.
    - path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.CreateCluster
      name: createcluster
      operations:
      - method: POST
        name: createcluster
        description: AWS Fargate Create an ECS cluster
        call: fargate.createcluster
        outputParameters:
        - type: object
          mapping: $.
    - path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DescribeClusters
      name: describeclusters
      operations:
      - method: POST
        name: describeclusters
        description: AWS Fargate Describe one or more clusters
        call: fargate.describeclusters
        outputParameters:
        - type: object
          mapping: $.
    - path: /#X-Amz-Target=AmazonEC2ContainerServiceV20141113.ExecuteCommand
      name: executecommand
      operations:
      - method: POST
        name: executecommand
        description: AWS Fargate Execute a command in a Fargate task container
        call: fargate.executecommand
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: fargate-mcp
    transport: http
    description: MCP adapter for AWS Fargate Amazon ECS API (Fargate) for AI agent use.
    tools:
    - name: registertaskdefinition
      description: AWS Fargate Register a Fargate task definition
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: fargate.registertaskdefinition
      outputParameters:
      - type: object
        mapping: $.
    - name: describetaskdefinition
      description: AWS Fargate Describe a task definition
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: fargate.describetaskdefinition
      outputParameters:
      - type: object
        mapping: $.
    - name: listtaskdefinitions
      description: AWS Fargate List task definitions
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: fargate.listtaskdefinitions
      outputParameters:
      - type: object
        mapping: $.
    - name: deregistertaskdefinition
      description: AWS Fargate Deregister a task definition
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: fargate.deregistertaskdefinition
      outputParameters:
      - type: object
        mapping: $.
    - name: runtask
      description: AWS Fargate Run a Fargate task
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: fargate.runtask
      outputParameters:
      - type: object
        mapping: $.
    - name: stoptask
      description: AWS Fargate Stop a running task
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: fargate.stoptask
      outputParameters:
      - type: object
        mapping: $.
    - name: describetasks
      description: AWS Fargate Describe one or more tasks
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: fargate.describetasks
      outputParameters:
      - type: object
        mapping: $.
    - name: listtasks
      description: AWS Fargate List tasks in a cluster
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: fargate.listtasks
      outputParameters:
      - type: object
        mapping: $.
    - name: createservice
      description: AWS Fargate Create a Fargate service
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: fargate.createservice
      outputParameters:
      - type: object
        mapping: $.
    - name: updateservice
      description: AWS Fargate Update a Fargate service
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: fargate.updateservice
      outputParameters:
      - type: object
        mapping: $.
    - name: deleteservice
      description: AWS Fargate Delete a service
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: fargate.deleteservice
      outputParameters:
      - type: object
        mapping: $.
    - name: describeservices
      description: AWS Fargate Describe one or more services
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: fargate.describeservices
      outputParameters:
      - type: object
        mapping: $.
    - name: listservices
      description: AWS Fargate List services in a cluster
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: fargate.listservices
      outputParameters:
      - type: object
        mapping: $.
    - name: createcluster
      description: AWS Fargate Create an ECS cluster
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: fargate.createcluster
      outputParameters:
      - type: object
        mapping: $.
    - name: describeclusters
      description: AWS Fargate Describe one or more clusters
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: fargate.describeclusters
      outputParameters:
      - type: object
        mapping: $.
    - name: executecommand
      description: AWS Fargate Execute a command in a Fargate task container
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: fargate.executecommand
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    FARGATE_TOKEN: FARGATE_TOKEN