naftiko: 1.0.0-alpha2
info:
  label: Sportmonks Football API — Livescores
  description: 'Sportmonks Football API — Livescores. 2 operations. Lead operation: List Livescores. Self-contained Naftiko
    capability covering one Sportmonks business surface.'
  tags:
    - Sportmonks
    - Football
    - Livescores
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
  - namespace: env
    keys:
      SPORTMONKS_API_TOKEN: SPORTMONKS_API_TOKEN
capability:
  consumes:
    - type: http
      namespace: football-livescores
      baseUri: https://api.sportmonks.com/v3/football
      description: Sportmonks Football Livescores business capability. Self-contained, no shared references.
      resources:
        - name: livescores
          path: /livescores
          operations:
            - name: listLivescores
              method: GET
              description: List Livescores
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: include
                  in: query
                  type: string
                  description: Semicolon-separated includes (e.g., participants;scores).
                  required: false
                - name: filters
                  in: query
                  type: string
                  description: Semicolon-separated filter expressions.
                  required: false
        - name: livescores-inplay
          path: /livescores/inplay
          operations:
            - name: listInplayLivescores
              method: GET
              description: List In-Play Livescores
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: include
                  in: query
                  type: string
                  required: false
      authentication:
        type: apikey
        key: api_token
        value: '{{env.SPORTMONKS_API_TOKEN}}'
        placement: query
  exposes:
    - type: rest
      namespace: football-livescores-rest
      port: 8080
      description: REST adapter for Sportmonks Football Livescores. One Spectral-compliant resource per consumed operation,
        prefixed with /v1.
      resources:
        - path: /v1/livescores
          name: livescores
          description: REST surface for livescores.
          operations:
            - method: GET
              name: listLivescores
              description: List Livescores
              call: football-livescores.listLivescores
              with:
                include: rest.include
                filters: rest.filters
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/livescores/inplay
          name: livescores-inplay
          description: REST surface for in-play livescores.
          operations:
            - method: GET
              name: listInplayLivescores
              description: List In-Play Livescores
              call: football-livescores.listInplayLivescores
              with:
                include: rest.include
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      namespace: football-livescores-mcp
      port: 9090
      transport: http
      description: MCP adapter for Sportmonks Football Livescores. One tool per consumed operation.
      tools:
        - name: list-livescores
          description: List Livescores
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: football-livescores.listLivescores
          with:
            include: tools.include
            filters: tools.filters
          outputParameters:
            - type: object
              mapping: $.
        - name: list-inplay-livescores
          description: List In-Play Livescores
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: football-livescores.listInplayLivescores
          with:
            include: tools.include
          outputParameters:
            - type: object
              mapping: $.