Amazon RDS API — DB Clusters

naftiko: 1.0.0-alpha2
info:
  label: Amazon RDS API — DB Clusters
  description: 'Amazon RDS API — DB Clusters. 3 operations. Lead operation: Amazon RDS Create a new DB cluster. Self-contained
    Naftiko capability covering one Amazon Rds business surface.'
  tags:
  - Amazon Rds
  - DB Clusters
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    AMAZON_RDS_API_KEY: AMAZON_RDS_API_KEY
capability:
  consumes:
  - type: http
    namespace: amazon-rds-db-clusters
    baseUri: https://rds.{region}.amazonaws.com
    description: Amazon RDS API — DB Clusters business capability. Self-contained, no shared references.
    resources:
    - name: ?Action=CreateDBCluster
      path: /?Action=CreateDBCluster
      operations:
      - name: createdbcluster
        method: GET
        description: Amazon RDS Create a new DB cluster
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: DBClusterIdentifier
          in: query
          type: string
          description: The DB cluster identifier, unique for each DB cluster
          required: true
        - name: Engine
          in: query
          type: string
          description: The database engine to use (aurora-mysql, aurora-postgresql)
          required: true
        - name: EngineVersion
          in: query
          type: string
          description: The version number of the database engine to use
        - name: MasterUsername
          in: query
          type: string
          description: The name of the master user for the DB cluster
        - name: MasterUserPassword
          in: query
          type: string
          description: The password for the master database user
        - name: DatabaseName
          in: query
          type: string
          description: The name for a database to create in the DB cluster
        - name: Port
          in: query
          type: integer
          description: The port number on which the instances in the DB cluster accept connections
        - name: DBSubnetGroupName
          in: query
          type: string
          description: A DB subnet group to associate with this DB cluster
        - name: VpcSecurityGroupIds.member.1
          in: query
          type: string
          description: A VPC security group to associate with the DB cluster
        - name: StorageEncrypted
          in: query
          type: boolean
          description: Whether the DB cluster is encrypted
        - name: BackupRetentionPeriod
          in: query
          type: integer
          description: The number of days for which automated backups are retained (1-35)
    - name: ?Action=DeleteDBCluster
      path: /?Action=DeleteDBCluster
      operations:
      - name: deletedbcluster
        method: GET
        description: Amazon RDS Delete a DB cluster
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: DBClusterIdentifier
          in: query
          type: string
          description: The DB cluster identifier for the DB cluster to be deleted
          required: true
        - name: SkipFinalSnapshot
          in: query
          type: boolean
          description: Whether to skip the creation of a final DB cluster snapshot before deleting the cluster
        - name: FinalDBSnapshotIdentifier
          in: query
          type: string
          description: The identifier of the final DB cluster snapshot to create before deleting the cluster
    - name: ?Action=DescribeDBClusters
      path: /?Action=DescribeDBClusters
      operations:
      - name: describedbclusters
        method: GET
        description: Amazon RDS Describe DB clusters
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: DBClusterIdentifier
          in: query
          type: string
          description: The identifier of the DB cluster to describe
        - name: Filters.member.1.Name
          in: query
          type: string
          description: The name of a filter
        - name: Filters.member.1.Values.member.1
          in: query
          type: string
          description: A value for the filter
        - name: MaxRecords
          in: query
          type: integer
          description: Maximum number of records to include in the response
        - name: Marker
          in: query
          type: string
          description: An optional pagination token provided by a previous request
    authentication:
      type: apikey
      key: Authorization
      value: '{{env.AMAZON_RDS_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: amazon-rds-db-clusters-rest
    port: 8080
    description: REST adapter for Amazon RDS API — DB Clusters. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/action-createdbcluster
      name: action-createdbcluster
      description: REST surface for ?Action=CreateDBCluster.
      operations:
      - method: GET
        name: createdbcluster
        description: Amazon RDS Create a new DB cluster
        call: amazon-rds-db-clusters.createdbcluster
        with:
          DBClusterIdentifier: rest.DBClusterIdentifier
          Engine: rest.Engine
          EngineVersion: rest.EngineVersion
          MasterUsername: rest.MasterUsername
          MasterUserPassword: rest.MasterUserPassword
          DatabaseName: rest.DatabaseName
          Port: rest.Port
          DBSubnetGroupName: rest.DBSubnetGroupName
          VpcSecurityGroupIds.member.1: rest.VpcSecurityGroupIds.member.1
          StorageEncrypted: rest.StorageEncrypted
          BackupRetentionPeriod: rest.BackupRetentionPeriod
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/action-deletedbcluster
      name: action-deletedbcluster
      description: REST surface for ?Action=DeleteDBCluster.
      operations:
      - method: GET
        name: deletedbcluster
        description: Amazon RDS Delete a DB cluster
        call: amazon-rds-db-clusters.deletedbcluster
        with:
          DBClusterIdentifier: rest.DBClusterIdentifier
          SkipFinalSnapshot: rest.SkipFinalSnapshot
          FinalDBSnapshotIdentifier: rest.FinalDBSnapshotIdentifier
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/action-describedbclusters
      name: action-describedbclusters
      description: REST surface for ?Action=DescribeDBClusters.
      operations:
      - method: GET
        name: describedbclusters
        description: Amazon RDS Describe DB clusters
        call: amazon-rds-db-clusters.describedbclusters
        with:
          DBClusterIdentifier: rest.DBClusterIdentifier
          Filters.member.1.Name: rest.Filters.member.1.Name
          Filters.member.1.Values.member.1: rest.Filters.member.1.Values.member.1
          MaxRecords: rest.MaxRecords
          Marker: rest.Marker
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: amazon-rds-db-clusters-mcp
    port: 9090
    transport: http
    description: MCP adapter for Amazon RDS API — DB Clusters. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: amazon-rds-create-new-db
      description: Amazon RDS Create a new DB cluster
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: amazon-rds-db-clusters.createdbcluster
      with:
        DBClusterIdentifier: tools.DBClusterIdentifier
        Engine: tools.Engine
        EngineVersion: tools.EngineVersion
        MasterUsername: tools.MasterUsername
        MasterUserPassword: tools.MasterUserPassword
        DatabaseName: tools.DatabaseName
        Port: tools.Port
        DBSubnetGroupName: tools.DBSubnetGroupName
        VpcSecurityGroupIds.member.1: tools.VpcSecurityGroupIds.member.1
        StorageEncrypted: tools.StorageEncrypted
        BackupRetentionPeriod: tools.BackupRetentionPeriod
      outputParameters:
      - type: object
        mapping: $.
    - name: amazon-rds-delete-db-cluster
      description: Amazon RDS Delete a DB cluster
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: amazon-rds-db-clusters.deletedbcluster
      with:
        DBClusterIdentifier: tools.DBClusterIdentifier
        SkipFinalSnapshot: tools.SkipFinalSnapshot
        FinalDBSnapshotIdentifier: tools.FinalDBSnapshotIdentifier
      outputParameters:
      - type: object
        mapping: $.
    - name: amazon-rds-describe-db-clusters
      description: Amazon RDS Describe DB clusters
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: amazon-rds-db-clusters.describedbclusters
      with:
        DBClusterIdentifier: tools.DBClusterIdentifier
        Filters.member.1.Name: tools.Filters.member.1.Name
        Filters.member.1.Values.member.1: tools.Filters.member.1.Values.member.1
        MaxRecords: tools.MaxRecords
        Marker: tools.Marker
      outputParameters:
      - type: object
        mapping: $.