naftiko: 1.0.0-alpha2
info:
  label: TravelCenters of America Fleet and Driver Services
  description: Workflow capability for fleet operators and professional truck drivers using TravelCenters of America (TA/Petro)
    locations. Covers location discovery, parking and shower availability, fuel pricing, truck service work orders, and fleet
    fuel code management.
  tags:
  - Travel Centers
  - Truck Service
  - Fleet Management
  - Fuel
  - Locations
  - Trucking
  - Driver Services
  created: '2026-05-03'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    TA_API_TOKEN: TA_API_TOKEN
capability:
  consumes:
  - type: http
    namespace: ta
    baseUri: https://api.accessta.com/v1
    description: TravelCenters of America REST APIs for truck service and retail operations.
    authentication:
      type: bearer
      token: '{{TA_API_TOKEN}}'
    resources:
    - name: locations
      path: /locations
      description: Travel center location search
      operations:
      - name: list-locations
        method: GET
        description: List TA/Petro travel center locations with amenity details
        inputParameters:
        - name: lat
          in: query
          type: number
          required: false
          description: Latitude for proximity search
        - name: lon
          in: query
          type: number
          required: false
          description: Longitude for proximity search
        - name: radius
          in: query
          type: number
          required: false
          description: Search radius in miles
        - name: brand
          in: query
          type: string
          required: false
          description: TA, Petro, or TA Express
        - name: state
          in: query
          type: string
          required: false
          description: US state code
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: parking
      path: /parking/availability
      description: Truck parking availability
      operations:
      - name: get-parking-availability
        method: GET
        description: Get real-time truck parking availability at travel centers
        inputParameters:
        - name: location_id
          in: query
          type: string
          required: false
          description: Filter by location ID
        - name: lat
          in: query
          type: number
          required: false
          description: Latitude for proximity search
        - name: lon
          in: query
          type: number
          required: false
          description: Longitude for proximity search
        - name: radius
          in: query
          type: number
          required: false
          description: Search radius in miles
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: showers
      path: /showers/availability
      description: Shower facility availability
      operations:
      - name: get-shower-availability
        method: GET
        description: Get shower availability at travel centers
        inputParameters:
        - name: location_id
          in: query
          type: string
          required: false
          description: Filter by location ID
        - name: lat
          in: query
          type: number
          required: false
          description: Latitude for proximity search
        - name: lon
          in: query
          type: number
          required: false
          description: Longitude for proximity search
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: work-orders
      path: /truck-service/work-orders
      description: Truck service work order management
      operations:
      - name: list-work-orders
        method: GET
        description: List truck service work orders
        inputParameters:
        - name: status
          in: query
          type: string
          required: false
          description: Filter by status
        - name: location_id
          in: query
          type: string
          required: false
          description: Filter by service location
        - name: start_date
          in: query
          type: string
          required: false
          description: Filter from date
        - name: end_date
          in: query
          type: string
          required: false
          description: Filter to date
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: documents
      path: /truck-service/documents
      description: Truck service documentation search
      operations:
      - name: search-documents
        method: GET
        description: Search truck service documents including invoices and service records
        inputParameters:
        - name: work_order_id
          in: query
          type: string
          required: false
          description: Filter by work order ID
        - name: vehicle_id
          in: query
          type: string
          required: false
          description: Filter by vehicle ID
        - name: document_type
          in: query
          type: string
          required: false
          description: Filter by document type
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: fuel-codes
      path: /fuel-codes
      description: Fleet fuel code management
      operations:
      - name: list-fuel-codes
        method: GET
        description: List fuel codes for the fleet account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pricing
      path: /pricing
      description: Fuel and service pricing
      operations:
      - name: get-pricing
        method: GET
        description: Get current fuel pricing at travel center locations
        inputParameters:
        - name: location_id
          in: query
          type: string
          required: false
          description: Filter by location
        - name: fuel_type
          in: query
          type: string
          required: false
          description: Filter by fuel type
        - name: lat
          in: query
          type: number
          required: false
          description: Latitude for proximity search
        - name: lon
          in: query
          type: number
          required: false
          description: Longitude for proximity search
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: fleet-driver-api
    description: Unified REST API for fleet and driver services at TA/Petro travel centers.
    resources:
    - path: /v1/locations
      name: locations
      description: Travel center location discovery
      operations:
      - method: GET
        name: list-locations
        description: Find travel centers by proximity, brand, or state
        call: ta.list-locations
        with:
          lat: rest.lat
          lon: rest.lon
          radius: rest.radius
          brand: rest.brand
          state: rest.state
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/parking
      name: parking
      description: Truck parking availability
      operations:
      - method: GET
        name: get-parking-availability
        description: Get real-time truck parking availability
        call: ta.get-parking-availability
        with:
          location_id: rest.location_id
          lat: rest.lat
          lon: rest.lon
          radius: rest.radius
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/showers
      name: showers
      description: Shower facility availability
      operations:
      - method: GET
        name: get-shower-availability
        description: Get shower availability and wait times
        call: ta.get-shower-availability
        with:
          location_id: rest.location_id
          lat: rest.lat
          lon: rest.lon
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/fuel-pricing
      name: fuel-pricing
      description: Fuel prices at travel centers
      operations:
      - method: GET
        name: get-pricing
        description: Get current diesel, gasoline, and DEF pricing
        call: ta.get-pricing
        with:
          location_id: rest.location_id
          fuel_type: rest.fuel_type
          lat: rest.lat
          lon: rest.lon
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/work-orders
      name: work-orders
      description: Truck service work orders
      operations:
      - method: GET
        name: list-work-orders
        description: List truck service work orders
        call: ta.list-work-orders
        with:
          status: rest.status
          location_id: rest.location_id
          start_date: rest.start_date
          end_date: rest.end_date
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/documents
      name: documents
      description: Service documentation search
      operations:
      - method: GET
        name: search-documents
        description: Search service records, invoices, and maintenance documents
        call: ta.search-documents
        with:
          work_order_id: rest.work_order_id
          vehicle_id: rest.vehicle_id
          document_type: rest.document_type
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/fuel-codes
      name: fuel-codes
      description: Fleet fuel code management
      operations:
      - method: GET
        name: list-fuel-codes
        description: List fuel codes for the fleet
        call: ta.list-fuel-codes
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: fleet-driver-mcp
    transport: http
    description: MCP server for AI-assisted fleet management and driver services at TA/Petro.
    tools:
    - name: find-travel-centers
      description: Find TA, Petro, or TA Express travel centers near a location
      hints:
        readOnly: true
        openWorld: true
      call: ta.list-locations
      with:
        lat: tools.lat
        lon: tools.lon
        radius: tools.radius
        brand: tools.brand
        state: tools.state
      outputParameters:
      - type: object
        mapping: $.
    - name: check-parking-availability
      description: Check real-time truck parking availability at travel centers
      hints:
        readOnly: true
        openWorld: true
      call: ta.get-parking-availability
      with:
        location_id: tools.location_id
        lat: tools.lat
        lon: tools.lon
        radius: tools.radius
      outputParameters:
      - type: object
        mapping: $.
    - name: check-shower-availability
      description: Check shower facility availability and wait times at travel centers
      hints:
        readOnly: true
        openWorld: true
      call: ta.get-shower-availability
      with:
        location_id: tools.location_id
        lat: tools.lat
        lon: tools.lon
      outputParameters:
      - type: object
        mapping: $.
    - name: get-fuel-pricing
      description: Get current diesel, gasoline, and DEF pricing at travel centers
      hints:
        readOnly: true
        openWorld: true
      call: ta.get-pricing
      with:
        location_id: tools.location_id
        fuel_type: tools.fuel_type
        lat: tools.lat
        lon: tools.lon
      outputParameters:
      - type: object
        mapping: $.
    - name: list-work-orders
      description: List truck service work orders for fleet vehicles
      hints:
        readOnly: true
        openWorld: false
      call: ta.list-work-orders
      with:
        status: tools.status
        location_id: tools.location_id
        start_date: tools.start_date
        end_date: tools.end_date
      outputParameters:
      - type: object
        mapping: $.
    - name: search-service-documents
      description: Search truck service records, invoices, and maintenance documents
      hints:
        readOnly: true
        openWorld: false
      call: ta.search-documents
      with:
        work_order_id: tools.work_order_id
        vehicle_id: tools.vehicle_id
        document_type: tools.document_type
      outputParameters:
      - type: object
        mapping: $.
    - name: list-fuel-codes
      description: List fleet fuel authorization codes for TA/Petro locations
      hints:
        readOnly: true
        openWorld: false
      call: ta.list-fuel-codes
      outputParameters:
      - type: object
        mapping: $.