naftiko: 1.0.0-alpha2
info:
  label: Omnisend REST API — Analytics Reports
  description: 'Omnisend Analytics capability. Retrieve aggregated marketing analytics — Reports group by message send date, Statistics group by event date.'
  tags:
    - Omnisend
    - Analytics
    - Reporting
    - Revenue Attribution
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
  - namespace: env
    keys:
      OMNISEND_API_KEY: OMNISEND_API_KEY
capability:
  consumes:
    - type: http
      namespace: analytics-reports
      baseUri: https://api.omnisend.com/v5
      description: Omnisend Analytics business capability.
      resources:
        - name: analytics-reports
          path: /analytics-reports
          operations:
            - name: getAnalyticsReports
              method: POST
              description: Aggregated analytics grouped by send date
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: $. }]
              inputParameters: [{ name: body, in: body, type: object, required: true }]
        - name: analytics-statistics
          path: /analytics-statistics
          operations:
            - name: getAnalyticsStatistics
              method: POST
              description: Aggregated analytics grouped by event date
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: $. }]
              inputParameters: [{ name: body, in: body, type: object, required: true }]
      authentication:
        type: apikey
        key: X-API-KEY
        value: '{{env.OMNISEND_API_KEY}}'
        placement: header
  exposes:
    - type: mcp
      namespace: analytics-reports-mcp
      port: 9090
      transport: http
      description: MCP adapter for Omnisend Analytics.
      tools:
        - name: omnisend-get-analytics-reports
          description: Aggregated Omnisend analytics by send date
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: analytics-reports.getAnalyticsReports
          with: { body: tools.body }
          outputParameters: [{ type: object, mapping: $. }]
        - name: omnisend-get-analytics-statistics
          description: Aggregated Omnisend analytics by event date
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: analytics-reports.getAnalyticsStatistics
          with: { body: tools.body }
          outputParameters: [{ type: object, mapping: $. }]