naftiko: "1.0.0-alpha2"

info:
  title: Kong MCP Registry Publish
  description: >-
    Publishes Naftiko-built MCP servers and their tools into Kong MCP
    Registry — Kong's centralized MCP server directory with discovery,
    governance gates, tool approval, and per-tool usage observability.
    When Naftiko ships an exposes:mcp capability, this capability registers
    it so agents can discover the new MCP through Kong's governed catalog.
  tags:
    - Naftiko
    - Kong
    - Partnership
    - MCP
    - Registry
    - AI-Gateway
  created: '2026-05-15'
  modified: '2026-05-15'

binds:
  - namespace: kong-konnect
    description: Kong Konnect Platform API endpoint + token.
    keys:
      KONG_KONNECT_BASE: KONG_KONNECT_BASE
      KONG_KONNECT_TOKEN: KONG_KONNECT_TOKEN

capability:
  consumes:
    - namespace: kong
      type: http
      baseUri: '{{KONG_KONNECT_BASE}}'
      authentication:
        type: bearer
        token: '{{KONG_KONNECT_TOKEN}}'
      resources:
        - name: mcp-servers
          path: '/v1/mcp/servers'
          operations:
            - name: list-mcp-servers
              method: GET
            - name: register-mcp-server
              method: POST
        - name: mcp-server
          path: '/v1/mcp/servers/{{server_id}}'
          operations:
            - name: get-mcp-server
              method: GET
              inputParameters:
                - { name: server_id, in: path, required: true }
            - name: update-mcp-server
              method: PATCH
              inputParameters:
                - { name: server_id, in: path, required: true }
            - name: delete-mcp-server
              method: DELETE
              inputParameters:
                - { name: server_id, in: path, required: true }
        - name: mcp-tools
          path: '/v1/mcp/servers/{{server_id}}/tools'
          operations:
            - name: list-mcp-tools
              method: GET
              inputParameters:
                - { name: server_id, in: path, required: true }
            - name: publish-mcp-tool
              method: POST
              inputParameters:
                - { name: server_id, in: path, required: true }
        - name: mcp-tool-approval
          path: '/v1/mcp/servers/{{server_id}}/tools/{{tool_id}}/_approve'
          operations:
            - name: approve-mcp-tool
              method: POST
              inputParameters:
                - { name: server_id, in: path, required: true }
                - { name: tool_id, in: path, required: true }

  exposes:
    - type: rest
      address: 0.0.0.0
      port: 8080
      namespace: kong-mcp-registry-publish-rest
      description: REST surface for publishing Naftiko-built MCP servers + tools into Kong MCP Registry.
      resources:
        - name: mcp-servers
          path: '/mcp/servers'
          operations:
            - name: list-mcp-servers
              method: GET
              call: kong.list-mcp-servers
            - name: register-mcp-server
              method: POST
              call: kong.register-mcp-server
        - name: mcp-server
          path: '/mcp/servers/{server_id}'
          operations:
            - name: get-mcp-server
              method: GET
              inputParameters:
                - { name: server_id, in: path, type: string, required: true }
              call: kong.get-mcp-server
            - name: update-mcp-server
              method: PATCH
              inputParameters:
                - { name: server_id, in: path, type: string, required: true }
              call: kong.update-mcp-server
            - name: delete-mcp-server
              method: DELETE
              inputParameters:
                - { name: server_id, in: path, type: string, required: true }
              call: kong.delete-mcp-server
        - name: mcp-tools
          path: '/mcp/servers/{server_id}/tools'
          operations:
            - name: list-mcp-tools
              method: GET
              inputParameters:
                - { name: server_id, in: path, type: string, required: true }
              call: kong.list-mcp-tools
            - name: publish-mcp-tool
              method: POST
              inputParameters:
                - { name: server_id, in: path, type: string, required: true }
              call: kong.publish-mcp-tool
        - name: mcp-tool-approval
          path: '/mcp/servers/{server_id}/tools/{tool_id}/approve'
          operations:
            - name: approve-mcp-tool
              method: POST
              inputParameters:
                - { name: server_id, in: path, type: string, required: true }
                - { name: tool_id, in: path, type: string, required: true }
              call: kong.approve-mcp-tool

    - type: mcp
      address: 0.0.0.0
      port: 3010
      namespace: kong-mcp-registry-publish-mcp
      description: MCP server for managing Kong MCP Registry entries from agents.
      tools:
        - name: list-mcp-servers
          description: List MCP servers registered in Kong MCP Registry.
          hints: { readOnly: true }
          call: kong.list-mcp-servers
        - name: register-mcp-server
          description: Register a new MCP server in Kong MCP Registry (typically a Naftiko-built MCP).
          hints: { destructiveHint: false }
          call: kong.register-mcp-server
        - name: get-mcp-server
          description: Get a single Kong-registered MCP server.
          hints: { readOnly: true }
          inputParameters:
            - { name: server_id, type: string, required: true }
          call: kong.get-mcp-server
        - name: update-mcp-server
          description: Update a Kong-registered MCP server.
          hints: { destructiveHint: true }
          inputParameters:
            - { name: server_id, type: string, required: true }
          call: kong.update-mcp-server
        - name: delete-mcp-server
          description: Deregister an MCP server from Kong MCP Registry.
          hints: { destructiveHint: true }
          inputParameters:
            - { name: server_id, type: string, required: true }
          call: kong.delete-mcp-server
        - name: list-mcp-tools
          description: List MCP tools exposed by a Kong-registered MCP server.
          hints: { readOnly: true }
          inputParameters:
            - { name: server_id, type: string, required: true }
          call: kong.list-mcp-tools
        - name: publish-mcp-tool
          description: Publish a new MCP tool on a Kong-registered MCP server.
          hints: { destructiveHint: false }
          inputParameters:
            - { name: server_id, type: string, required: true }
          call: kong.publish-mcp-tool
        - name: approve-mcp-tool
          description: Approve a Kong MCP Registry tool for agent discovery (governance gate).
          hints: { destructiveHint: false }
          inputParameters:
            - { name: server_id, type: string, required: true }
            - { name: tool_id, type: string, required: true }
          call: kong.approve-mcp-tool