naftiko: 1.0.0-alpha2
info:
  label: Emissary-Ingress Configuration API
  description: Emissary-Ingress is a CNCF incubating Kubernetes-native API gateway and ingress controller built on the Envoy
    proxy. It is configured through Kubernetes Custom Resource Definitions (CRDs) including Mapping for request routing, Host
    for domain and TLS management, TLSContext for TLS termination settings, RateLimitService for delegating rate limiting
    to external services, and AuthService for external authentication. All resources are managed through the Kubernetes API
    server using standard CRUD operations.
  tags:
  - Emissary
  - Ingress
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: emissary-ingress
    baseUri: https://localhost:6443
    description: Emissary-Ingress Configuration API HTTP API.
    resources:
    - name: apis-getambassador-io-v3alpha1-namespaces-namesp
      path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/mappings
      operations:
      - name: listnamespacedmapping
        method: GET
        description: Emissary-Ingress List Mapping resources in a namespace
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createnamespacedmapping
        method: POST
        description: Emissary-Ingress Create a Mapping resource
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: apis-getambassador-io-v3alpha1-namespaces-namesp
      path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/mappings/{name}
      operations:
      - name: readnamespacedmapping
        method: GET
        description: Emissary-Ingress Get a specific Mapping resource
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: replacenamespacedmapping
        method: PUT
        description: Emissary-Ingress Replace a Mapping resource
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: patchnamespacedmapping
        method: PATCH
        description: Emissary-Ingress Partially update a Mapping resource
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletenamespacedmapping
        method: DELETE
        description: Emissary-Ingress Delete a Mapping resource
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: apis-getambassador-io-v3alpha1-mappings
      path: /apis/getambassador.io/v3alpha1/mappings
      operations:
      - name: listmappingallnamespaces
        method: GET
        description: Emissary-Ingress List Mapping resources across all namespaces
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: apis-getambassador-io-v3alpha1-namespaces-namesp
      path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/hosts
      operations:
      - name: listnamespacedhost
        method: GET
        description: Emissary-Ingress List Host resources in a namespace
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createnamespacedhost
        method: POST
        description: Emissary-Ingress Create a Host resource
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: apis-getambassador-io-v3alpha1-namespaces-namesp
      path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/hosts/{name}
      operations:
      - name: readnamespacedhost
        method: GET
        description: Emissary-Ingress Get a specific Host resource
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: replacenamespacedhost
        method: PUT
        description: Emissary-Ingress Replace a Host resource
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletenamespacedhost
        method: DELETE
        description: Emissary-Ingress Delete a Host resource
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: apis-getambassador-io-v3alpha1-namespaces-namesp
      path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/tlscontexts
      operations:
      - name: listnamespacedtlscontext
        method: GET
        description: Emissary-Ingress List TLSContext resources in a namespace
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createnamespacedtlscontext
        method: POST
        description: Emissary-Ingress Create a TLSContext resource
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: apis-getambassador-io-v3alpha1-namespaces-namesp
      path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/tlscontexts/{name}
      operations:
      - name: readnamespacedtlscontext
        method: GET
        description: Emissary-Ingress Get a specific TLSContext resource
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletenamespacedtlscontext
        method: DELETE
        description: Emissary-Ingress Delete a TLSContext resource
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: apis-getambassador-io-v3alpha1-namespaces-namesp
      path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/ratelimitservices
      operations:
      - name: listnamespacedratelimitservice
        method: GET
        description: Emissary-Ingress List RateLimitService resources in a namespace
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createnamespacedratelimitservice
        method: POST
        description: Emissary-Ingress Create a RateLimitService resource
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: apis-getambassador-io-v3alpha1-namespaces-namesp
      path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/authservices
      operations:
      - name: listnamespacedauthservice
        method: GET
        description: Emissary-Ingress List AuthService resources in a namespace
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createnamespacedauthservice
        method: POST
        description: Emissary-Ingress Create an AuthService resource
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: emissary-ingress-rest
    description: REST adapter for Emissary-Ingress Configuration API.
    resources:
    - path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/mappings
      name: listnamespacedmapping
      operations:
      - method: GET
        name: listnamespacedmapping
        description: Emissary-Ingress List Mapping resources in a namespace
        call: emissary-ingress.listnamespacedmapping
        outputParameters:
        - type: object
          mapping: $.
    - path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/mappings
      name: createnamespacedmapping
      operations:
      - method: POST
        name: createnamespacedmapping
        description: Emissary-Ingress Create a Mapping resource
        call: emissary-ingress.createnamespacedmapping
        outputParameters:
        - type: object
          mapping: $.
    - path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/mappings/{name}
      name: readnamespacedmapping
      operations:
      - method: GET
        name: readnamespacedmapping
        description: Emissary-Ingress Get a specific Mapping resource
        call: emissary-ingress.readnamespacedmapping
        outputParameters:
        - type: object
          mapping: $.
    - path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/mappings/{name}
      name: replacenamespacedmapping
      operations:
      - method: PUT
        name: replacenamespacedmapping
        description: Emissary-Ingress Replace a Mapping resource
        call: emissary-ingress.replacenamespacedmapping
        outputParameters:
        - type: object
          mapping: $.
    - path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/mappings/{name}
      name: patchnamespacedmapping
      operations:
      - method: PATCH
        name: patchnamespacedmapping
        description: Emissary-Ingress Partially update a Mapping resource
        call: emissary-ingress.patchnamespacedmapping
        outputParameters:
        - type: object
          mapping: $.
    - path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/mappings/{name}
      name: deletenamespacedmapping
      operations:
      - method: DELETE
        name: deletenamespacedmapping
        description: Emissary-Ingress Delete a Mapping resource
        call: emissary-ingress.deletenamespacedmapping
        outputParameters:
        - type: object
          mapping: $.
    - path: /apis/getambassador.io/v3alpha1/mappings
      name: listmappingallnamespaces
      operations:
      - method: GET
        name: listmappingallnamespaces
        description: Emissary-Ingress List Mapping resources across all namespaces
        call: emissary-ingress.listmappingallnamespaces
        outputParameters:
        - type: object
          mapping: $.
    - path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/hosts
      name: listnamespacedhost
      operations:
      - method: GET
        name: listnamespacedhost
        description: Emissary-Ingress List Host resources in a namespace
        call: emissary-ingress.listnamespacedhost
        outputParameters:
        - type: object
          mapping: $.
    - path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/hosts
      name: createnamespacedhost
      operations:
      - method: POST
        name: createnamespacedhost
        description: Emissary-Ingress Create a Host resource
        call: emissary-ingress.createnamespacedhost
        outputParameters:
        - type: object
          mapping: $.
    - path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/hosts/{name}
      name: readnamespacedhost
      operations:
      - method: GET
        name: readnamespacedhost
        description: Emissary-Ingress Get a specific Host resource
        call: emissary-ingress.readnamespacedhost
        outputParameters:
        - type: object
          mapping: $.
    - path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/hosts/{name}
      name: replacenamespacedhost
      operations:
      - method: PUT
        name: replacenamespacedhost
        description: Emissary-Ingress Replace a Host resource
        call: emissary-ingress.replacenamespacedhost
        outputParameters:
        - type: object
          mapping: $.
    - path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/hosts/{name}
      name: deletenamespacedhost
      operations:
      - method: DELETE
        name: deletenamespacedhost
        description: Emissary-Ingress Delete a Host resource
        call: emissary-ingress.deletenamespacedhost
        outputParameters:
        - type: object
          mapping: $.
    - path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/tlscontexts
      name: listnamespacedtlscontext
      operations:
      - method: GET
        name: listnamespacedtlscontext
        description: Emissary-Ingress List TLSContext resources in a namespace
        call: emissary-ingress.listnamespacedtlscontext
        outputParameters:
        - type: object
          mapping: $.
    - path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/tlscontexts
      name: createnamespacedtlscontext
      operations:
      - method: POST
        name: createnamespacedtlscontext
        description: Emissary-Ingress Create a TLSContext resource
        call: emissary-ingress.createnamespacedtlscontext
        outputParameters:
        - type: object
          mapping: $.
    - path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/tlscontexts/{name}
      name: readnamespacedtlscontext
      operations:
      - method: GET
        name: readnamespacedtlscontext
        description: Emissary-Ingress Get a specific TLSContext resource
        call: emissary-ingress.readnamespacedtlscontext
        outputParameters:
        - type: object
          mapping: $.
    - path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/tlscontexts/{name}
      name: deletenamespacedtlscontext
      operations:
      - method: DELETE
        name: deletenamespacedtlscontext
        description: Emissary-Ingress Delete a TLSContext resource
        call: emissary-ingress.deletenamespacedtlscontext
        outputParameters:
        - type: object
          mapping: $.
    - path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/ratelimitservices
      name: listnamespacedratelimitservice
      operations:
      - method: GET
        name: listnamespacedratelimitservice
        description: Emissary-Ingress List RateLimitService resources in a namespace
        call: emissary-ingress.listnamespacedratelimitservice
        outputParameters:
        - type: object
          mapping: $.
    - path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/ratelimitservices
      name: createnamespacedratelimitservice
      operations:
      - method: POST
        name: createnamespacedratelimitservice
        description: Emissary-Ingress Create a RateLimitService resource
        call: emissary-ingress.createnamespacedratelimitservice
        outputParameters:
        - type: object
          mapping: $.
    - path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/authservices
      name: listnamespacedauthservice
      operations:
      - method: GET
        name: listnamespacedauthservice
        description: Emissary-Ingress List AuthService resources in a namespace
        call: emissary-ingress.listnamespacedauthservice
        outputParameters:
        - type: object
          mapping: $.
    - path: /apis/getambassador.io/v3alpha1/namespaces/{namespace}/authservices
      name: createnamespacedauthservice
      operations:
      - method: POST
        name: createnamespacedauthservice
        description: Emissary-Ingress Create an AuthService resource
        call: emissary-ingress.createnamespacedauthservice
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: emissary-ingress-mcp
    transport: http
    description: MCP adapter for Emissary-Ingress Configuration API for AI agent use.
    tools:
    - name: listnamespacedmapping
      description: Emissary-Ingress List Mapping resources in a namespace
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: emissary-ingress.listnamespacedmapping
      outputParameters:
      - type: object
        mapping: $.
    - name: createnamespacedmapping
      description: Emissary-Ingress Create a Mapping resource
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: emissary-ingress.createnamespacedmapping
      outputParameters:
      - type: object
        mapping: $.
    - name: readnamespacedmapping
      description: Emissary-Ingress Get a specific Mapping resource
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: emissary-ingress.readnamespacedmapping
      outputParameters:
      - type: object
        mapping: $.
    - name: replacenamespacedmapping
      description: Emissary-Ingress Replace a Mapping resource
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: emissary-ingress.replacenamespacedmapping
      outputParameters:
      - type: object
        mapping: $.
    - name: patchnamespacedmapping
      description: Emissary-Ingress Partially update a Mapping resource
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: emissary-ingress.patchnamespacedmapping
      outputParameters:
      - type: object
        mapping: $.
    - name: deletenamespacedmapping
      description: Emissary-Ingress Delete a Mapping resource
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: emissary-ingress.deletenamespacedmapping
      outputParameters:
      - type: object
        mapping: $.
    - name: listmappingallnamespaces
      description: Emissary-Ingress List Mapping resources across all namespaces
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: emissary-ingress.listmappingallnamespaces
      outputParameters:
      - type: object
        mapping: $.
    - name: listnamespacedhost
      description: Emissary-Ingress List Host resources in a namespace
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: emissary-ingress.listnamespacedhost
      outputParameters:
      - type: object
        mapping: $.
    - name: createnamespacedhost
      description: Emissary-Ingress Create a Host resource
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: emissary-ingress.createnamespacedhost
      outputParameters:
      - type: object
        mapping: $.
    - name: readnamespacedhost
      description: Emissary-Ingress Get a specific Host resource
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: emissary-ingress.readnamespacedhost
      outputParameters:
      - type: object
        mapping: $.
    - name: replacenamespacedhost
      description: Emissary-Ingress Replace a Host resource
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: emissary-ingress.replacenamespacedhost
      outputParameters:
      - type: object
        mapping: $.
    - name: deletenamespacedhost
      description: Emissary-Ingress Delete a Host resource
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: emissary-ingress.deletenamespacedhost
      outputParameters:
      - type: object
        mapping: $.
    - name: listnamespacedtlscontext
      description: Emissary-Ingress List TLSContext resources in a namespace
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: emissary-ingress.listnamespacedtlscontext
      outputParameters:
      - type: object
        mapping: $.
    - name: createnamespacedtlscontext
      description: Emissary-Ingress Create a TLSContext resource
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: emissary-ingress.createnamespacedtlscontext
      outputParameters:
      - type: object
        mapping: $.
    - name: readnamespacedtlscontext
      description: Emissary-Ingress Get a specific TLSContext resource
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: emissary-ingress.readnamespacedtlscontext
      outputParameters:
      - type: object
        mapping: $.
    - name: deletenamespacedtlscontext
      description: Emissary-Ingress Delete a TLSContext resource
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: emissary-ingress.deletenamespacedtlscontext
      outputParameters:
      - type: object
        mapping: $.
    - name: listnamespacedratelimitservice
      description: Emissary-Ingress List RateLimitService resources in a namespace
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: emissary-ingress.listnamespacedratelimitservice
      outputParameters:
      - type: object
        mapping: $.
    - name: createnamespacedratelimitservice
      description: Emissary-Ingress Create a RateLimitService resource
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: emissary-ingress.createnamespacedratelimitservice
      outputParameters:
      - type: object
        mapping: $.
    - name: listnamespacedauthservice
      description: Emissary-Ingress List AuthService resources in a namespace
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: emissary-ingress.listnamespacedauthservice
      outputParameters:
      - type: object
        mapping: $.
    - name: createnamespacedauthservice
      description: Emissary-Ingress Create an AuthService resource
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: emissary-ingress.createnamespacedauthservice
      outputParameters:
      - type: object
        mapping: $.