Microsoft Azure Azure Communication CallingServer Service — ServerCall

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Azure Communication CallingServer Service — ServerCall
  description: 'Microsoft Azure Azure Communication CallingServer Service — ServerCall. 4 operations. Lead operation: Microsoft
    Azure Join A Call. Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - ServerCall
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: azure-communication-callingserver-service-servercall
    baseUri: ''
    description: Microsoft Azure Azure Communication CallingServer Service — ServerCall business capability. Self-contained,
      no shared references.
    resources:
    - name: calling-serverCalls-serverCallId-:join
      path: /calling/serverCalls/{serverCallId}/:join
      operations:
      - name: microsoftazureservercallsjoincall
        method: POST
        description: Microsoft Azure Join A Call
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: serverCallId
          in: path
          type: string
          description: The server call id.
          required: true
        - name: callRequest
          in: body
          type: string
          description: The join call request.
          required: true
    - name: calling-serverCalls-serverCallId-:playAudio
      path: /calling/serverCalls/{serverCallId}/:playAudio
      operations:
      - name: microsoftazureservercallsplayaudio
        method: POST
        description: Microsoft Azure Play Audio In The Call
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: serverCallId
          in: path
          type: string
          description: The server call id.
          required: true
        - name: request
          in: body
          type: string
          description: Play audio request.
          required: true
    - name: calling-serverCalls-serverCallId-participants
      path: /calling/serverCalls/{serverCallId}/participants
      operations:
      - name: microsoftazureservercallsaddparticipant
        method: POST
        description: Microsoft Azure Add A Participant To The Call
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: serverCallId
          in: path
          type: string
          description: The server call id.
          required: true
        - name: addParticipantRequest
          in: body
          type: string
          description: The add participant request.
          required: true
    - name: calling-serverCalls-serverCallId-participants-participantId
      path: /calling/serverCalls/{serverCallId}/participants/{participantId}
      operations:
      - name: microsoftazureservercallsremoveparticipant
        method: DELETE
        description: Microsoft Azure Remove Participant From The Call
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: serverCallId
          in: path
          type: string
          description: Server call id.
          required: true
        - name: participantId
          in: path
          type: string
          description: Participant id.
          required: true
  exposes:
  - type: rest
    namespace: azure-communication-callingserver-service-servercall-rest
    port: 8080
    description: REST adapter for Microsoft Azure Azure Communication CallingServer Service — ServerCall. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/calling/servercalls/{servercallid}/join
      name: calling-servercalls-servercallid-join
      description: REST surface for calling-serverCalls-serverCallId-:join.
      operations:
      - method: POST
        name: microsoftazureservercallsjoincall
        description: Microsoft Azure Join A Call
        call: azure-communication-callingserver-service-servercall.microsoftazureservercallsjoincall
        with:
          serverCallId: rest.serverCallId
          callRequest: rest.callRequest
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calling/servercalls/{servercallid}/playaudio
      name: calling-servercalls-servercallid-playaudio
      description: REST surface for calling-serverCalls-serverCallId-:playAudio.
      operations:
      - method: POST
        name: microsoftazureservercallsplayaudio
        description: Microsoft Azure Play Audio In The Call
        call: azure-communication-callingserver-service-servercall.microsoftazureservercallsplayaudio
        with:
          serverCallId: rest.serverCallId
          request: rest.request
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calling/servercalls/{servercallid}/participants
      name: calling-servercalls-servercallid-participants
      description: REST surface for calling-serverCalls-serverCallId-participants.
      operations:
      - method: POST
        name: microsoftazureservercallsaddparticipant
        description: Microsoft Azure Add A Participant To The Call
        call: azure-communication-callingserver-service-servercall.microsoftazureservercallsaddparticipant
        with:
          serverCallId: rest.serverCallId
          addParticipantRequest: rest.addParticipantRequest
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/calling/servercalls/{servercallid}/participants/{participantid}
      name: calling-servercalls-servercallid-participants-participantid
      description: REST surface for calling-serverCalls-serverCallId-participants-participantId.
      operations:
      - method: DELETE
        name: microsoftazureservercallsremoveparticipant
        description: Microsoft Azure Remove Participant From The Call
        call: azure-communication-callingserver-service-servercall.microsoftazureservercallsremoveparticipant
        with:
          serverCallId: rest.serverCallId
          participantId: rest.participantId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: azure-communication-callingserver-service-servercall-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Azure Communication CallingServer Service — ServerCall. One tool per consumed
      operation, routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-join-call
      description: Microsoft Azure Join A Call
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-communication-callingserver-service-servercall.microsoftazureservercallsjoincall
      with:
        serverCallId: tools.serverCallId
        callRequest: tools.callRequest
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-play-audio-call
      description: Microsoft Azure Play Audio In The Call
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-communication-callingserver-service-servercall.microsoftazureservercallsplayaudio
      with:
        serverCallId: tools.serverCallId
        request: tools.request
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-add-participant-call
      description: Microsoft Azure Add A Participant To The Call
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-communication-callingserver-service-servercall.microsoftazureservercallsaddparticipant
      with:
        serverCallId: tools.serverCallId
        addParticipantRequest: tools.addParticipantRequest
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-remove-participant-call
      description: Microsoft Azure Remove Participant From The Call
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: azure-communication-callingserver-service-servercall.microsoftazureservercallsremoveparticipant
      with:
        serverCallId: tools.serverCallId
        participantId: tools.participantId
      outputParameters:
      - type: object
        mapping: $.