naftiko: 1.0.0-alpha2
info:
  label: Toast Restaurant Operations
  description: Unified workflow capability combining Toast Orders and Labor APIs for day-to-day restaurant operations management.
    Enables operators to monitor orders, manage payments, and oversee staff from a single interface. Used by restaurant managers
    and operations teams.
  tags:
  - Toast
  - Restaurant
  - Orders
  - Labor
  - Point of Sale
  created: '2026-05-03'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    TOAST_CLIENT_ID: TOAST_CLIENT_ID
    TOAST_CLIENT_SECRET: TOAST_CLIENT_SECRET
    TOAST_RESTAURANT_GUID: TOAST_RESTAURANT_GUID
    TOAST_ACCESS_TOKEN: TOAST_ACCESS_TOKEN
capability:
  consumes:
  - type: http
    namespace: toast-orders
    baseUri: https://ws-api.toasttab.com
    description: Toast Orders API
    authentication:
      type: bearer
      token: '{{TOAST_ACCESS_TOKEN}}'
    resources:
    - name: orders
      path: /orders
      description: Restaurant orders
      operations:
      - name: getOrder
        method: GET
        description: Toast Get an Order
        inputParameters:
        - name: guid
          in: path
          type: string
          required: true
          description: The GUID of the order
        - name: Toast-Restaurant-External-ID
          in: header
          type: string
          required: true
          description: Restaurant GUID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getOrdersBulk
        method: GET
        description: Toast Get Multiple Orders
        inputParameters:
        - name: Toast-Restaurant-External-ID
          in: header
          type: string
          required: true
          description: Restaurant GUID
        - name: startDate
          in: query
          type: string
          required: false
          description: Start date for order query
        - name: endDate
          in: query
          type: string
          required: false
          description: End date for order query
        outputRawFormat: json
        outputParameters:
        - name: result
          type: array
          value: $.
    - name: payments
      path: /payments
      description: Order payments
      operations:
      - name: getPayments
        method: GET
        description: Toast Get Payment Identifiers
        inputParameters:
        - name: Toast-Restaurant-External-ID
          in: header
          type: string
          required: true
          description: Restaurant GUID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: array
          value: $.
      - name: getPayment
        method: GET
        description: Toast Get a Payment
        inputParameters:
        - name: guid
          in: path
          type: string
          required: true
          description: Payment GUID
        - name: Toast-Restaurant-External-ID
          in: header
          type: string
          required: true
          description: Restaurant GUID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  - type: http
    namespace: toast-labor
    baseUri: https://ws-api.toasttab.com
    description: Toast Labor API
    authentication:
      type: bearer
      token: '{{TOAST_ACCESS_TOKEN}}'
    resources:
    - name: employees
      path: /employees
      description: Restaurant employees
      operations:
      - name: listEmployees
        method: GET
        description: Toast List Employees
        inputParameters:
        - name: Toast-Restaurant-External-ID
          in: header
          type: string
          required: true
          description: Restaurant GUID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: array
          value: $.
      - name: createEmployee
        method: POST
        description: Toast Create an Employee
        inputParameters:
        - name: Toast-Restaurant-External-ID
          in: header
          type: string
          required: true
          description: Restaurant GUID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            firstName: '{{tools.firstName}}'
            lastName: '{{tools.lastName}}'
            email: '{{tools.email}}'
      - name: getEmployee
        method: GET
        description: Toast Get an Employee
        inputParameters:
        - name: employeeId
          in: path
          type: string
          required: true
          description: Employee identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateEmployee
        method: PATCH
        description: Toast Update an Employee
        inputParameters:
        - name: employeeId
          in: path
          type: string
          required: true
          description: Employee identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteEmployee
        method: DELETE
        description: Toast Delete an Employee
        inputParameters:
        - name: employeeId
          in: path
          type: string
          required: true
          description: Employee identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: restaurant-operations-api
    description: Unified REST API for Toast restaurant operations.
    resources:
    - path: /v1/orders
      name: orders
      description: Restaurant orders
      operations:
      - method: GET
        name: list-orders
        description: Get multiple restaurant orders
        call: toast-orders.getOrdersBulk
        outputParameters:
        - type: array
          mapping: $.
    - path: /v1/orders/{guid}
      name: order
      description: Individual restaurant order
      operations:
      - method: GET
        name: get-order
        description: Get a specific restaurant order
        call: toast-orders.getOrder
        with:
          guid: rest.guid
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/payments
      name: payments
      description: Order payments
      operations:
      - method: GET
        name: list-payments
        description: Get payment identifiers
        call: toast-orders.getPayments
        outputParameters:
        - type: array
          mapping: $.
    - path: /v1/employees
      name: employees
      description: Restaurant employees
      operations:
      - method: GET
        name: list-employees
        description: List restaurant employees
        call: toast-labor.listEmployees
        outputParameters:
        - type: array
          mapping: $.
      - method: POST
        name: create-employee
        description: Create a new employee
        call: toast-labor.createEmployee
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/employees/{id}
      name: employee
      description: Individual employee
      operations:
      - method: GET
        name: get-employee
        description: Get employee details
        call: toast-labor.getEmployee
        with:
          employeeId: rest.id
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: restaurant-operations-mcp
    transport: http
    description: MCP server for AI-assisted restaurant operations management.
    tools:
    - name: list-restaurant-orders
      description: Get multiple orders for a restaurant in a date range
      hints:
        readOnly: true
        openWorld: true
      call: toast-orders.getOrdersBulk
      outputParameters:
      - type: array
        mapping: $.
    - name: get-restaurant-order
      description: Get details of a specific restaurant order
      hints:
        readOnly: true
        openWorld: false
      call: toast-orders.getOrder
      with:
        guid: tools.guid
      outputParameters:
      - type: object
        mapping: $.
    - name: list-order-payments
      description: List payment records for a restaurant
      hints:
        readOnly: true
        openWorld: true
      call: toast-orders.getPayments
      outputParameters:
      - type: array
        mapping: $.
    - name: get-order-payment
      description: Get details of a specific payment
      hints:
        readOnly: true
        openWorld: false
      call: toast-orders.getPayment
      with:
        guid: tools.guid
      outputParameters:
      - type: object
        mapping: $.
    - name: list-employees
      description: List all employees at a restaurant location
      hints:
        readOnly: true
        openWorld: true
      call: toast-labor.listEmployees
      outputParameters:
      - type: array
        mapping: $.
    - name: get-employee
      description: Get a specific employee record
      hints:
        readOnly: true
        openWorld: false
      call: toast-labor.getEmployee
      with:
        employeeId: tools.employeeId
      outputParameters:
      - type: object
        mapping: $.
    - name: create-employee
      description: Create a new employee record at a restaurant
      hints:
        readOnly: false
        openWorld: false
      call: toast-labor.createEmployee
      outputParameters:
      - type: object
        mapping: $.
    - name: update-employee
      description: Update employee information
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: toast-labor.updateEmployee
      with:
        employeeId: tools.employeeId
      outputParameters:
      - type: object
        mapping: $.