Rollbar Error Monitoring

naftiko: "1.0.0-alpha1"

info:
  label: "Rollbar Error Monitoring"
  description: >-
    Unified workflow capability for error monitoring, incident triage, and
    deployment correlation using Rollbar REST and RQL APIs. Enables engineering
    teams and on-call engineers to investigate errors, query occurrence data,
    correlate issues with deployments, and manage error item lifecycle from
    detection through resolution.
  tags:
    - Error Tracking
    - Monitoring
    - Incident Response
    - DevOps
    - Rollbar
  created: "2026-05-02"
  modified: "2026-05-02"

binds:
  - namespace: env
    keys:
      ROLLBAR_ACCESS_TOKEN: ROLLBAR_ACCESS_TOKEN

capability:
  consumes:
    - import: rollbar
      location: ./shared/rollbar-rest-api.yaml

  exposes:
    - type: rest
      port: 8080
      namespace: rollbar-error-monitoring-api
      description: "Unified REST API for Rollbar error monitoring and incident triage."
      resources:
        - path: /v1/errors
          name: errors
          description: "Error item management and triage"
          operations:
            - method: GET
              name: list-errors
              description: "List all tracked error items with filtering by status and severity"
              call: "rollbar.list-all-items"
              with:
                status: "rest.status"
                level: "rest.level"
                environment: "rest.environment"
              outputParameters:
                - type: object
                  mapping: "$."

            - method: POST
              name: report-error
              description: "Report a new error or exception to Rollbar"
              call: "rollbar.create-item"
              with:
                payload: "rest.payload"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/errors/{itemId}
          name: error-detail
          description: "Individual error item management"
          operations:
            - method: GET
              name: get-error
              description: "Get detailed information about a specific error item"
              call: "rollbar.get-item-by-id"
              with:
                itemId: "rest.itemId"
              outputParameters:
                - type: object
                  mapping: "$."

            - method: PATCH
              name: update-error-status
              description: "Update error status (resolve, mute, activate)"
              call: "rollbar.update-item"
              with:
                itemId: "rest.itemId"
                status: "rest.status"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/occurrences
          name: occurrences
          description: "Individual error occurrence retrieval"
          operations:
            - method: GET
              name: list-occurrences
              description: "List all individual error occurrences in the project"
              call: "rollbar.list-project-occurrences"
              outputParameters:
                - type: object
                  mapping: "$."

            - method: GET
              name: get-occurrence
              description: "Get a specific error occurrence with full stack trace"
              call: "rollbar.get-occurrence"
              with:
                instanceId: "rest.instanceId"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/projects
          name: projects
          description: "Rollbar project administration"
          operations:
            - method: GET
              name: list-projects
              description: "List all Rollbar projects"
              call: "rollbar.list-all-projects"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/notifications
          name: notifications
          description: "Webhook notification configuration"
          operations:
            - method: GET
              name: get-notification-config
              description: "Get webhook notification configuration"
              call: "rollbar.get-webhook-config"
              outputParameters:
                - type: object
                  mapping: "$."

            - method: GET
              name: list-notification-rules
              description: "List all notification rules"
              call: "rollbar.list-webhook-rules"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      port: 9080
      namespace: rollbar-error-monitoring-mcp
      transport: http
      description: "MCP server for AI-assisted error monitoring, triage, and incident response."
      tools:
        - name: list-errors
          description: "List tracked error items filtered by status, level, or environment"
          hints:
            readOnly: true
            openWorld: true
          call: "rollbar.list-all-items"
          with:
            status: "tools.status"
            level: "tools.level"
            environment: "tools.environment"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-error
          description: "Get detailed information about a specific error item including stack trace and metadata"
          hints:
            readOnly: true
            openWorld: false
          call: "rollbar.get-item-by-id"
          with:
            itemId: "tools.itemId"
          outputParameters:
            - type: object
              mapping: "$."

        - name: report-error
          description: "Report a new error or exception to Rollbar for tracking"
          hints:
            readOnly: false
            destructive: false
          call: "rollbar.create-item"
          with:
            payload: "tools.payload"
          outputParameters:
            - type: object
              mapping: "$."

        - name: resolve-error
          description: "Mark an error item as resolved"
          hints:
            readOnly: false
            destructive: false
            idempotent: true
          call: "rollbar.update-item"
          with:
            itemId: "tools.itemId"
            status: "resolved"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-occurrences
          description: "List individual error occurrences with full details and stack traces"
          hints:
            readOnly: true
            openWorld: true
          call: "rollbar.list-project-occurrences"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-occurrence
          description: "Get a specific error occurrence including full stack trace, request data, and context"
          hints:
            readOnly: true
            openWorld: false
          call: "rollbar.get-occurrence"
          with:
            instanceId: "tools.instanceId"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-projects
          description: "List all Rollbar projects in the account"
          hints:
            readOnly: true
            openWorld: true
          call: "rollbar.list-all-projects"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-teams
          description: "List all teams in the Rollbar account"
          hints:
            readOnly: true
            openWorld: true
          call: "rollbar.list-all-teams"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-notification-config
          description: "Get current webhook notification configuration"
          hints:
            readOnly: true
            openWorld: false
          call: "rollbar.get-webhook-config"
          outputParameters:
            - type: object
              mapping: "$."