naftiko: "1.0.0-alpha2"

info:
  title: Gravitee Federation Bridge
  description: >-
    Pulls federated API discovery from Gravitee — APIs that Gravitee
    Federation has discovered across AWS API Gateway, Apigee, Kong,
    Azure API Management, MuleSoft — into Naftiko Fleet, so Naftiko's
    capability registry sees every governed API in the org regardless
    of which gateway terminates it.
  tags:
    - Naftiko
    - Gravitee
    - Partnership
    - Federation
    - Discovery
    - Multi-Gateway
  created: '2026-05-15'
  modified: '2026-05-15'

binds:
  - namespace: gravitee-env
    description: Gravitee APIM Management endpoint + token.
    keys:
      GRAVITEE_APIM_BASE: GRAVITEE_APIM_BASE
      GRAVITEE_APIM_TOKEN: GRAVITEE_APIM_TOKEN

capability:
  consumes:
    - namespace: gravitee
      type: http
      baseUri: '{{GRAVITEE_APIM_BASE}}'
      authentication:
        type: bearer
        token: '{{GRAVITEE_APIM_TOKEN}}'
      resources:
        - name: integrations
          path: '/management/v2/environments/{{env_id}}/integrations'
          operations:
            - name: list-integrations
              method: GET
              inputParameters:
                - { name: env_id, in: path, required: true }
            - name: create-integration
              method: POST
              inputParameters:
                - { name: env_id, in: path, required: true }
        - name: integration
          path: '/management/v2/environments/{{env_id}}/integrations/{{integration_id}}'
          operations:
            - name: get-integration
              method: GET
              inputParameters:
                - { name: env_id, in: path, required: true }
                - { name: integration_id, in: path, required: true }
            - name: delete-integration
              method: DELETE
              inputParameters:
                - { name: env_id, in: path, required: true }
                - { name: integration_id, in: path, required: true }
        - name: integration-discover
          path: '/management/v2/environments/{{env_id}}/integrations/{{integration_id}}/_discover'
          operations:
            - name: discover-integration
              method: POST
              inputParameters:
                - { name: env_id, in: path, required: true }
                - { name: integration_id, in: path, required: true }
        - name: federated-apis
          path: '/management/v2/environments/{{env_id}}/integrations/{{integration_id}}/apis'
          operations:
            - name: list-federated-apis
              method: GET
              inputParameters:
                - { name: env_id, in: path, required: true }
                - { name: integration_id, in: path, required: true }
        - name: ingest-federated-api
          path: '/management/v2/environments/{{env_id}}/integrations/{{integration_id}}/apis/_ingest'
          operations:
            - name: ingest-federated-api
              method: POST
              inputParameters:
                - { name: env_id, in: path, required: true }
                - { name: integration_id, in: path, required: true }

  exposes:
    - type: rest
      address: 0.0.0.0
      port: 8080
      namespace: gravitee-federation-bridge-rest
      description: REST surface for managing Gravitee Federation integrations + federated API discovery.
      resources:
        - name: integrations
          path: '/environments/{env_id}/integrations'
          operations:
            - name: list-integrations
              method: GET
              inputParameters:
                - { name: env_id, in: path, type: string, required: true }
              call: gravitee.list-integrations
            - name: create-integration
              method: POST
              inputParameters:
                - { name: env_id, in: path, type: string, required: true }
              call: gravitee.create-integration
        - name: integration
          path: '/environments/{env_id}/integrations/{integration_id}'
          operations:
            - name: get-integration
              method: GET
              inputParameters:
                - { name: env_id, in: path, type: string, required: true }
                - { name: integration_id, in: path, type: string, required: true }
              call: gravitee.get-integration
            - name: delete-integration
              method: DELETE
              inputParameters:
                - { name: env_id, in: path, type: string, required: true }
                - { name: integration_id, in: path, type: string, required: true }
              call: gravitee.delete-integration
        - name: discover-integration
          path: '/environments/{env_id}/integrations/{integration_id}/discover'
          operations:
            - name: discover-integration
              method: POST
              inputParameters:
                - { name: env_id, in: path, type: string, required: true }
                - { name: integration_id, in: path, type: string, required: true }
              call: gravitee.discover-integration
        - name: federated-apis
          path: '/environments/{env_id}/integrations/{integration_id}/apis'
          operations:
            - name: list-federated-apis
              method: GET
              inputParameters:
                - { name: env_id, in: path, type: string, required: true }
                - { name: integration_id, in: path, type: string, required: true }
              call: gravitee.list-federated-apis
        - name: ingest-federated-api
          path: '/environments/{env_id}/integrations/{integration_id}/apis/ingest'
          operations:
            - name: ingest-federated-api
              method: POST
              inputParameters:
                - { name: env_id, in: path, type: string, required: true }
                - { name: integration_id, in: path, type: string, required: true }
              call: gravitee.ingest-federated-api

    - type: mcp
      address: 0.0.0.0
      port: 3010
      namespace: gravitee-federation-bridge-mcp
      description: MCP server for pulling federated API discovery from Gravitee into Naftiko Fleet.
      tools:
        - name: list-integrations
          description: List Gravitee Federation integrations (AWS API Gateway, Apigee, Kong, Azure APIM, MuleSoft).
          hints: { readOnly: true }
          inputParameters:
            - { name: env_id, type: string, required: true }
          call: gravitee.list-integrations
        - name: create-integration
          description: Register a new Gravitee Federation integration to a foreign gateway.
          hints: { destructiveHint: false }
          inputParameters:
            - { name: env_id, type: string, required: true }
          call: gravitee.create-integration
        - name: get-integration
          description: Get a single Gravitee Federation integration.
          hints: { readOnly: true }
          inputParameters:
            - { name: env_id, type: string, required: true }
            - { name: integration_id, type: string, required: true }
          call: gravitee.get-integration
        - name: delete-integration
          description: Delete a Gravitee Federation integration.
          hints: { destructiveHint: true }
          inputParameters:
            - { name: env_id, type: string, required: true }
            - { name: integration_id, type: string, required: true }
          call: gravitee.delete-integration
        - name: discover-integration
          description: Trigger a federated discovery scan against an integrated foreign gateway.
          hints: { destructiveHint: false }
          inputParameters:
            - { name: env_id, type: string, required: true }
            - { name: integration_id, type: string, required: true }
          call: gravitee.discover-integration
        - name: list-federated-apis
          description: List APIs that Gravitee Federation has discovered on an integrated foreign gateway.
          hints: { readOnly: true }
          inputParameters:
            - { name: env_id, type: string, required: true }
            - { name: integration_id, type: string, required: true }
          call: gravitee.list-federated-apis
        - name: ingest-federated-api
          description: Ingest a federated foreign-gateway API into Gravitee as a managed API.
          hints: { destructiveHint: false }
          inputParameters:
            - { name: env_id, type: string, required: true }
            - { name: integration_id, type: string, required: true }
          call: gravitee.ingest-federated-api