Konnect API - Go SDK — MCP Servers

naftiko: 1.0.0-alpha2
info:
  label: Konnect API - Go SDK — MCP Servers
  description: 'Konnect API - Go SDK — MCP Servers. 13 operations. Lead operation: List MCP Servers by Control Plane. Self-contained
    Naftiko capability covering one Kong business surface.'
  tags:
  - Kong
  - MCP Servers
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    KONG_API_KEY: KONG_API_KEY
capability:
  consumes:
  - type: http
    namespace: konnect-platform-mcp-servers
    baseUri: https://global.api.konghq.com
    description: Konnect API - Go SDK — MCP Servers business capability. Self-contained, no shared references.
    resources:
    - name: v1-mcp-cp-controlPlaneId-mcp-servers
      path: /v1/mcp-cp/{controlPlaneId}/mcp-servers
      operations:
      - name: listmcpserversbycontrolplane
        method: GET
        description: List MCP Servers by Control Plane
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-mcp-cp-controlPlaneId-mcp-servers-mcpServerId
      path: /v1/mcp-cp/{controlPlaneId}/mcp-servers/{mcpServerId}
      operations:
      - name: getmcpserverbycontrolplane
        method: GET
        description: Get MCP Server by Control Plane
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-mcp-cp-controlPlaneId-mcp-servers-mcpServerId-code
      path: /v1/mcp-cp/{controlPlaneId}/mcp-servers/{mcpServerId}/code
      operations:
      - name: getmcpservercode
        method: GET
        description: Get generated Python code for the MCP Server
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-mcp-cp-controlPlaneId-mcp-servers-mcpServerId-kong-entities
      path: /v1/mcp-cp/{controlPlaneId}/mcp-servers/{mcpServerId}/kong-entities
      operations:
      - name: getmcpserverkongentities
        method: GET
        description: Get Kong entities for the MCP Server Gateway
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: runtime_version
          in: query
          type: string
          description: Kong Gateway runtime version to generate entities for
    - name: v1-mcp-cp-controlPlaneId-mcp-servers-mcpServerId-status
      path: /v1/mcp-cp/{controlPlaneId}/mcp-servers/{mcpServerId}/status
      operations:
      - name: postmcpserverstatus
        method: POST
        description: Report MCP Server deployment status
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-mcp-cp-controlPlaneId-signals
      path: /v1/mcp-cp/{controlPlaneId}/signals
      operations:
      - name: getmcpserversignals
        method: GET
        description: Get MCP Server Signals
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-mcp-servers
      path: /v1/mcp-servers
      operations:
      - name: listmcpserverconfigs
        method: GET
        description: List all MCP Servers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createmcpserverconfig
        method: POST
        description: Create an MCP Server
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-mcp-servers-mcpServerId
      path: /v1/mcp-servers/{mcpServerId}
      operations:
      - name: getmcpserverconfig
        method: GET
        description: Get MCP Server
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updatemcpserverconfig
        method: PUT
        description: Update MCP Server
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: patchmcpserverconfig
        method: PATCH
        description: Partially Update MCP Server
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deletemcpserverconfig
        method: DELETE
        description: Delete MCP Server
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-mcp-servers-mcpServerId-status
      path: /v1/mcp-servers/{mcpServerId}/status
      operations:
      - name: getmcpserverstatus
        method: GET
        description: Get MCP Server deployment status
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      token: '{{env.KONG_API_KEY}}'
  exposes:
  - type: rest
    namespace: konnect-platform-mcp-servers-rest
    port: 8080
    description: REST adapter for Konnect API - Go SDK — MCP Servers. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/v1/mcp-cp/{controlplaneid}/mcp-servers
      name: v1-mcp-cp-controlplaneid-mcp-servers
      description: REST surface for v1-mcp-cp-controlPlaneId-mcp-servers.
      operations:
      - method: GET
        name: listmcpserversbycontrolplane
        description: List MCP Servers by Control Plane
        call: konnect-platform-mcp-servers.listmcpserversbycontrolplane
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/mcp-cp/{controlplaneid}/mcp-servers/{mcpserverid}
      name: v1-mcp-cp-controlplaneid-mcp-servers-mcpserverid
      description: REST surface for v1-mcp-cp-controlPlaneId-mcp-servers-mcpServerId.
      operations:
      - method: GET
        name: getmcpserverbycontrolplane
        description: Get MCP Server by Control Plane
        call: konnect-platform-mcp-servers.getmcpserverbycontrolplane
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/mcp-cp/{controlplaneid}/mcp-servers/{mcpserverid}/code
      name: v1-mcp-cp-controlplaneid-mcp-servers-mcpserverid-code
      description: REST surface for v1-mcp-cp-controlPlaneId-mcp-servers-mcpServerId-code.
      operations:
      - method: GET
        name: getmcpservercode
        description: Get generated Python code for the MCP Server
        call: konnect-platform-mcp-servers.getmcpservercode
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/mcp-cp/{controlplaneid}/mcp-servers/{mcpserverid}/kong-entities
      name: v1-mcp-cp-controlplaneid-mcp-servers-mcpserverid-kong-entities
      description: REST surface for v1-mcp-cp-controlPlaneId-mcp-servers-mcpServerId-kong-entities.
      operations:
      - method: GET
        name: getmcpserverkongentities
        description: Get Kong entities for the MCP Server Gateway
        call: konnect-platform-mcp-servers.getmcpserverkongentities
        with:
          runtime_version: rest.runtime_version
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/mcp-cp/{controlplaneid}/mcp-servers/{mcpserverid}/status
      name: v1-mcp-cp-controlplaneid-mcp-servers-mcpserverid-status
      description: REST surface for v1-mcp-cp-controlPlaneId-mcp-servers-mcpServerId-status.
      operations:
      - method: POST
        name: postmcpserverstatus
        description: Report MCP Server deployment status
        call: konnect-platform-mcp-servers.postmcpserverstatus
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/mcp-cp/{controlplaneid}/signals
      name: v1-mcp-cp-controlplaneid-signals
      description: REST surface for v1-mcp-cp-controlPlaneId-signals.
      operations:
      - method: GET
        name: getmcpserversignals
        description: Get MCP Server Signals
        call: konnect-platform-mcp-servers.getmcpserversignals
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/mcp-servers
      name: v1-mcp-servers
      description: REST surface for v1-mcp-servers.
      operations:
      - method: GET
        name: listmcpserverconfigs
        description: List all MCP Servers
        call: konnect-platform-mcp-servers.listmcpserverconfigs
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createmcpserverconfig
        description: Create an MCP Server
        call: konnect-platform-mcp-servers.createmcpserverconfig
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/mcp-servers/{mcpserverid}
      name: v1-mcp-servers-mcpserverid
      description: REST surface for v1-mcp-servers-mcpServerId.
      operations:
      - method: GET
        name: getmcpserverconfig
        description: Get MCP Server
        call: konnect-platform-mcp-servers.getmcpserverconfig
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updatemcpserverconfig
        description: Update MCP Server
        call: konnect-platform-mcp-servers.updatemcpserverconfig
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: patchmcpserverconfig
        description: Partially Update MCP Server
        call: konnect-platform-mcp-servers.patchmcpserverconfig
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deletemcpserverconfig
        description: Delete MCP Server
        call: konnect-platform-mcp-servers.deletemcpserverconfig
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/mcp-servers/{mcpserverid}/status
      name: v1-mcp-servers-mcpserverid-status
      description: REST surface for v1-mcp-servers-mcpServerId-status.
      operations:
      - method: GET
        name: getmcpserverstatus
        description: Get MCP Server deployment status
        call: konnect-platform-mcp-servers.getmcpserverstatus
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: konnect-platform-mcp-servers-mcp
    port: 9090
    transport: http
    description: MCP adapter for Konnect API - Go SDK — MCP Servers. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: list-mcp-servers-control-plane
      description: List MCP Servers by Control Plane
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-mcp-servers.listmcpserversbycontrolplane
      outputParameters:
      - type: object
        mapping: $.
    - name: get-mcp-server-control-plane
      description: Get MCP Server by Control Plane
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-mcp-servers.getmcpserverbycontrolplane
      outputParameters:
      - type: object
        mapping: $.
    - name: get-generated-python-code-mcp
      description: Get generated Python code for the MCP Server
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-mcp-servers.getmcpservercode
      outputParameters:
      - type: object
        mapping: $.
    - name: get-kong-entities-mcp-server
      description: Get Kong entities for the MCP Server Gateway
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-mcp-servers.getmcpserverkongentities
      with:
        runtime_version: tools.runtime_version
      outputParameters:
      - type: object
        mapping: $.
    - name: report-mcp-server-deployment-status
      description: Report MCP Server deployment status
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: konnect-platform-mcp-servers.postmcpserverstatus
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-mcp-server-signals
      description: Get MCP Server Signals
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-mcp-servers.getmcpserversignals
      outputParameters:
      - type: object
        mapping: $.
    - name: list-all-mcp-servers
      description: List all MCP Servers
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-mcp-servers.listmcpserverconfigs
      outputParameters:
      - type: object
        mapping: $.
    - name: create-mcp-server
      description: Create an MCP Server
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: konnect-platform-mcp-servers.createmcpserverconfig
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-mcp-server
      description: Get MCP Server
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-mcp-servers.getmcpserverconfig
      outputParameters:
      - type: object
        mapping: $.
    - name: update-mcp-server
      description: Update MCP Server
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: konnect-platform-mcp-servers.updatemcpserverconfig
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: partially-update-mcp-server
      description: Partially Update MCP Server
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: konnect-platform-mcp-servers.patchmcpserverconfig
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-mcp-server
      description: Delete MCP Server
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: konnect-platform-mcp-servers.deletemcpserverconfig
      outputParameters:
      - type: object
        mapping: $.
    - name: get-mcp-server-deployment-status
      description: Get MCP Server deployment status
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: konnect-platform-mcp-servers.getmcpserverstatus
      outputParameters:
      - type: object
        mapping: $.