naftiko: 1.0.0-alpha2
info:
  label: Rainbow Communications Platform
  description: Unified communications platform capability combining Rainbow CPaaS messaging, contacts, and directory. Used
    by developers building enterprise communication applications with chat, group collaboration, presence awareness, and contact
    management. Powered by Alcatel-Lucent Enterprise Rainbow APIs.
  tags:
  - Communications
  - CPaaS
  - Messaging
  - Chat
  - Contacts
  - Presence
  - Collaboration
  - Unified Communications
  created: '2026-05-02'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    RAINBOW_BEARER_TOKEN: RAINBOW_BEARER_TOKEN
capability:
  consumes:
  - type: http
    namespace: messaging
    baseUri: https://openrainbow.com/api/rainbow
    description: Rainbow Messaging REST API
    authentication:
      type: bearer
      token: '{{RAINBOW_BEARER_TOKEN}}'
    resources:
    - name: messages
      path: /enduser/v1.0/messages
      description: Send chat messages
      operations:
      - name: send-message
        method: POST
        description: Send a message to a contact or bubble
        body:
          type: json
          data:
            content: '{{tools.content}}'
            to: '{{tools.to}}'
            type: '{{tools.type}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: conversations
      path: /enduser/v1.0/conversations
      description: Manage conversations
      operations:
      - name: list-conversations
        method: GET
        description: List conversations for the authenticated user
        inputParameters:
        - name: limit
          in: query
          type: integer
          required: false
          description: Max results to return
        - name: offset
          in: query
          type: integer
          required: false
          description: Pagination offset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: conversation-messages
      path: /enduser/v1.0/conversations/{conversationId}/messages
      description: Get conversation message history
      operations:
      - name: get-conversation-messages
        method: GET
        description: Get message history for a conversation
        inputParameters:
        - name: conversationId
          in: path
          type: string
          required: true
          description: Conversation ID
        - name: limit
          in: query
          type: integer
          required: false
          description: Max messages to return
        - name: before
          in: query
          type: string
          required: false
          description: ISO 8601 timestamp for pagination
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: bubbles
      path: /enduser/v1.0/bubbles
      description: Manage group chat rooms
      operations:
      - name: list-bubbles
        method: GET
        description: List bubbles the user belongs to
        inputParameters:
        - name: limit
          in: query
          type: integer
          required: false
        - name: offset
          in: query
          type: integer
          required: false
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-bubble
        method: POST
        description: Create a new group chat room
        body:
          type: json
          data:
            name: '{{tools.name}}'
            topic: '{{tools.topic}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  - type: http
    namespace: contacts
    baseUri: https://openrainbow.com/api/rainbow
    description: Rainbow Contacts REST API
    authentication:
      type: bearer
      token: '{{RAINBOW_BEARER_TOKEN}}'
    resources:
    - name: contacts
      path: /enduser/v1.0/contacts
      description: Search and manage contacts
      operations:
      - name: search-contacts
        method: GET
        description: Search contacts by name, email, or phone
        inputParameters:
        - name: search
          in: query
          type: string
          required: false
          description: Search keyword
        - name: limit
          in: query
          type: integer
          required: false
        - name: offset
          in: query
          type: integer
          required: false
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: contact-detail
      path: /enduser/v1.0/contacts/{contactId}
      description: Get a specific contact
      operations:
      - name: get-contact
        method: GET
        description: Get contact profile and presence
        inputParameters:
        - name: contactId
          in: path
          type: string
          required: true
          description: Contact ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: my-profile
      path: /enduser/v1.0/users/me
      description: Authenticated user's profile
      operations:
      - name: get-my-profile
        method: GET
        description: Get current user's profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: my-presence
      path: /enduser/v1.0/users/me/presence
      description: Manage user presence status
      operations:
      - name: update-presence
        method: PUT
        description: Update presence status
        body:
          type: json
          data:
            presence: '{{tools.presence}}'
            status: '{{tools.status}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: communications-platform-api
    description: Unified REST API for Rainbow CPaaS communications and collaboration.
    resources:
    - path: /v1/messages
      name: messages
      description: Send and retrieve chat messages
      operations:
      - method: POST
        name: send-message
        description: Send a message to a contact or group
        call: messaging.send-message
        with:
          content: rest.content
          to: rest.to
          type: rest.type
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/conversations
      name: conversations
      description: List and manage conversations
      operations:
      - method: GET
        name: list-conversations
        description: List user conversations
        call: messaging.list-conversations
        with:
          limit: rest.limit
          offset: rest.offset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/bubbles
      name: bubbles
      description: Group chat rooms
      operations:
      - method: GET
        name: list-bubbles
        description: List group chat rooms
        call: messaging.list-bubbles
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-bubble
        description: Create a new group chat room
        call: messaging.create-bubble
        with:
          name: rest.name
          topic: rest.topic
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/contacts
      name: contacts
      description: Contact directory search
      operations:
      - method: GET
        name: search-contacts
        description: Search Rainbow directory
        call: contacts.search-contacts
        with:
          search: rest.search
          limit: rest.limit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/contacts/{id}
      name: contact-detail
      description: Individual contact profiles
      operations:
      - method: GET
        name: get-contact
        description: Get contact profile and presence
        call: contacts.get-contact
        with:
          contactId: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/users/me
      name: my-profile
      description: Authenticated user's profile
      operations:
      - method: GET
        name: get-my-profile
        description: Get own profile
        call: contacts.get-my-profile
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/users/me/presence
      name: my-presence
      description: User presence management
      operations:
      - method: PUT
        name: update-presence
        description: Update presence status
        call: contacts.update-presence
        with:
          presence: rest.presence
          status: rest.status
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: communications-platform-mcp
    transport: http
    description: MCP server for AI-assisted enterprise communications and collaboration.
    tools:
    - name: send-message
      description: Send a chat message to a Rainbow contact (1-to-1) or into a group bubble. Supports text messages via REST
        API.
      hints:
        readOnly: false
        destructive: false
      call: messaging.send-message
      with:
        content: tools.content
        to: tools.to
        type: tools.type
      outputParameters:
      - type: object
        mapping: $.
    - name: list-conversations
      description: List recent conversations for the authenticated Rainbow user
      hints:
        readOnly: true
        openWorld: false
      call: messaging.list-conversations
      with:
        limit: tools.limit
        offset: tools.offset
      outputParameters:
      - type: object
        mapping: $.
    - name: get-conversation-messages
      description: Get message history for a specific Rainbow conversation
      hints:
        readOnly: true
        openWorld: false
      call: messaging.get-conversation-messages
      with:
        conversationId: tools.conversationId
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: list-bubbles
      description: List group chat rooms (bubbles) the user belongs to in Rainbow
      hints:
        readOnly: true
        openWorld: false
      call: messaging.list-bubbles
      outputParameters:
      - type: object
        mapping: $.
    - name: create-bubble
      description: Create a new Rainbow group chat room (bubble) with optional members
      hints:
        readOnly: false
        destructive: false
      call: messaging.create-bubble
      with:
        name: tools.name
        topic: tools.topic
      outputParameters:
      - type: object
        mapping: $.
    - name: search-contacts
      description: Search Rainbow enterprise directory for contacts by name, email, or phone
      hints:
        readOnly: true
        openWorld: true
      call: contacts.search-contacts
      with:
        search: tools.search
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: get-contact
      description: Get Rainbow contact profile including presence status and contact details
      hints:
        readOnly: true
        openWorld: false
      call: contacts.get-contact
      with:
        contactId: tools.contactId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-my-profile
      description: Get the authenticated Rainbow user's own profile
      hints:
        readOnly: true
        openWorld: false
      call: contacts.get-my-profile
      outputParameters:
      - type: object
        mapping: $.
    - name: update-presence
      description: Update presence status in Rainbow (online, away, busy, dnd)
      hints:
        readOnly: false
        idempotent: true
      call: contacts.update-presence
      with:
        presence: tools.presence
        status: tools.status
      outputParameters:
      - type: object
        mapping: $.