NASCAR Feed API — Races

naftiko: 1.0.0-alpha2
info:
  label: NASCAR Feed API — Races
  description: 'NASCAR Feed API — Races. 5 operations. Lead operation: Infractions for a specific race. Self-contained Naftiko
    capability covering one Nascar business surface.'
  tags:
  - Nascar
  - Races
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    NASCAR_API_KEY: NASCAR_API_KEY
capability:
  consumes:
  - type: http
    namespace: nascar-races
    baseUri: https://feed.nascar.com
    description: NASCAR Feed API — Races business capability. Self-contained, no shared references.
    resources:
    - name: api-raceinfractions
      path: /api/raceinfractions
      operations:
      - name: getraceinfractions
        method: GET
        description: Infractions for a specific race
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: api-racelist
      path: /api/racelist
      operations:
      - name: getracelist
        method: GET
        description: Historical race listings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: api-races
      path: /api/races
      operations:
      - name: listraces
        method: GET
        description: Race results by season and series
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: api-races-race_id
      path: /api/races/{race_id}
      operations:
      - name: getrace
        method: GET
        description: Specific race details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: api-races-race_id-journal
      path: /api/races/{race_id}/journal
      operations:
      - name: getracejournal
        method: GET
        description: Race journal file download
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    namespace: nascar-races-rest
    port: 8080
    description: REST adapter for NASCAR Feed API — Races. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/api/raceinfractions
      name: api-raceinfractions
      description: REST surface for api-raceinfractions.
      operations:
      - method: GET
        name: getraceinfractions
        description: Infractions for a specific race
        call: nascar-races.getraceinfractions
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/racelist
      name: api-racelist
      description: REST surface for api-racelist.
      operations:
      - method: GET
        name: getracelist
        description: Historical race listings
        call: nascar-races.getracelist
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/races
      name: api-races
      description: REST surface for api-races.
      operations:
      - method: GET
        name: listraces
        description: Race results by season and series
        call: nascar-races.listraces
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/races/{race-id}
      name: api-races-race-id
      description: REST surface for api-races-race_id.
      operations:
      - method: GET
        name: getrace
        description: Specific race details
        call: nascar-races.getrace
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/races/{race-id}/journal
      name: api-races-race-id-journal
      description: REST surface for api-races-race_id-journal.
      operations:
      - method: GET
        name: getracejournal
        description: Race journal file download
        call: nascar-races.getracejournal
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: nascar-races-mcp
    port: 9090
    transport: http
    description: MCP adapter for NASCAR Feed API — Races. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: infractions-specific-race
      description: Infractions for a specific race
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: nascar-races.getraceinfractions
      outputParameters:
      - type: object
        mapping: $.
    - name: historical-race-listings
      description: Historical race listings
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: nascar-races.getracelist
      outputParameters:
      - type: object
        mapping: $.
    - name: race-results-season-and-series
      description: Race results by season and series
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: nascar-races.listraces
      outputParameters:
      - type: object
        mapping: $.
    - name: specific-race-details
      description: Specific race details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: nascar-races.getrace
      outputParameters:
      - type: object
        mapping: $.
    - name: race-journal-file-download
      description: Race journal file download
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: nascar-races.getracejournal
      outputParameters:
      - type: object
        mapping: $.