naftiko: 1.0.0-alpha2
info:
  label: Telefoon EU Communications
  description: Unified GDPR-compliant communications capability for European markets. Combines Telefoon Voice and SMS APIs
    for Dutch, Belgian, German, and EU-wide communications. Supports branded sender IDs, multi-language TTS, GDPR consent
    tracking, and EU data residency. Designed for developers building compliant European customer communication workflows.
  tags:
  - Belgium
  - CPaaS
  - EU Data Residency
  - Europe
  - GDPR Compliant
  - Messaging
  - Netherlands
  - SMS
  - Telephony
  - Voice
  created: '2026-05-03'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    TELEFOON_API_KEY: TELEFOON_API_KEY
capability:
  consumes:
  - type: http
    namespace: telefoon-voice
    baseUri: https://api.telefoon.com/v1/voice
    description: Telefoon Voice API — EU telephony platform
    authentication:
      type: apikey
      key: X-API-Key
      value: '{{TELEFOON_API_KEY}}'
      placement: header
    resources:
    - name: calls
      path: /calls
      description: Voice call management
      operations:
      - name: list-calls
        method: GET
        description: List voice calls
        inputParameters:
        - name: status
          in: query
          type: string
          required: false
          description: Filter by call status
        - name: direction
          in: query
          type: string
          required: false
          description: inbound or outbound
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: initiate-call
        method: POST
        description: Initiate an outbound voice call
        inputParameters:
        - name: to
          in: body
          type: string
          required: true
          description: Destination number (E.164)
        - name: from
          in: body
          type: string
          required: true
          description: Caller ID
        - name: tts_language
          in: body
          type: string
          required: false
          description: TTS language (nl-NL, fr-BE, de-DE, en-GB)
        - name: record
          in: body
          type: boolean
          required: false
          description: Record call (requires GDPR consent)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: conferences
      path: /conferences
      description: Conference management
      operations:
      - name: list-conferences
        method: GET
        description: List conferences
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-conference
        method: POST
        description: Create a conference room
        inputParameters:
        - name: friendly_name
          in: body
          type: string
          required: false
          description: Conference name
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  - type: http
    namespace: telefoon-sms
    baseUri: https://api.telefoon.com/v1/sms
    description: Telefoon SMS API
    authentication:
      type: apikey
      key: X-API-Key
      value: '{{TELEFOON_API_KEY}}'
      placement: header
    resources:
    - name: messages
      path: /messages
      description: SMS messaging
      operations:
      - name: list-messages
        method: GET
        description: List messages
        inputParameters:
        - name: direction
          in: query
          type: string
          required: false
          description: inbound or outbound
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: send-message
        method: POST
        description: Send an SMS with optional GDPR consent reference
        inputParameters:
        - name: to
          in: body
          type: string
          required: true
          description: Recipient (E.164)
        - name: from
          in: body
          type: string
          required: true
          description: Sender number or alphanumeric ID
        - name: body
          in: body
          type: string
          required: false
          description: Message text
        - name: gdpr_consent_ref
          in: body
          type: string
          required: false
          description: GDPR consent reference for audit
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: eu-communications-api
    description: Unified GDPR-compliant EU communications REST API.
    resources:
    - path: /v1/calls
      name: calls
      description: EU voice call management
      operations:
      - method: GET
        name: list-calls
        description: List voice calls
        call: telefoon-voice.list-calls
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: initiate-call
        description: Initiate an outbound EU call with multi-language TTS support
        call: telefoon-voice.initiate-call
        with:
          to: rest.to
          from: rest.from
          tts_language: rest.tts_language
          record: rest.record
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/conferences
      name: conferences
      description: EU conference calls
      operations:
      - method: GET
        name: list-conferences
        description: List conferences
        call: telefoon-voice.list-conferences
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-conference
        description: Create a conference room
        call: telefoon-voice.create-conference
        with:
          friendly_name: rest.friendly_name
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/messages
      name: messages
      description: GDPR-compliant SMS messaging
      operations:
      - method: GET
        name: list-messages
        description: List messages
        call: telefoon-sms.list-messages
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: send-message
        description: Send an SMS with optional branded sender ID and GDPR consent reference
        call: telefoon-sms.send-message
        with:
          to: rest.to
          from: rest.from
          body: rest.body
          gdpr_consent_ref: rest.gdpr_consent_ref
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: eu-communications-mcp
    transport: http
    description: MCP server for AI-assisted GDPR-compliant European communications.
    tools:
    - name: list-calls
      description: List EU voice calls with optional status and direction filters
      hints:
        readOnly: true
        openWorld: false
      call: telefoon-voice.list-calls
      outputParameters:
      - type: object
        mapping: $.
    - name: make-eu-call
      description: Initiate an outbound call via EU networks with multi-language TTS (nl-NL, fr-BE, de-DE, en-GB)
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telefoon-voice.initiate-call
      with:
        to: tools.to
        from: tools.from
        tts_language: tools.tts_language
        record: tools.record
      outputParameters:
      - type: object
        mapping: $.
    - name: list-conferences
      description: List EU conference calls
      hints:
        readOnly: true
        openWorld: false
      call: telefoon-voice.list-conferences
      outputParameters:
      - type: object
        mapping: $.
    - name: create-conference
      description: Create a new EU conference call room
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telefoon-voice.create-conference
      with:
        friendly_name: tools.friendly_name
      outputParameters:
      - type: object
        mapping: $.
    - name: list-messages
      description: List EU SMS messages sent or received
      hints:
        readOnly: true
        openWorld: false
      call: telefoon-sms.list-messages
      outputParameters:
      - type: object
        mapping: $.
    - name: send-eu-sms
      description: Send an SMS in European markets with branded sender ID and GDPR consent reference for compliance
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telefoon-sms.send-message
      with:
        to: tools.to
        from: tools.from
        body: tools.body
        gdpr_consent_ref: tools.gdpr_consent_ref
      outputParameters:
      - type: object
        mapping: $.