naftiko: 1.0.0-alpha2
info:
  label: Uber Food and Delivery
  description: Workflow capability combining Uber Eats (restaurant ordering and store management) and Uber Direct (on-demand
    courier delivery) APIs. Supports restaurant operators, e-commerce merchants, and delivery platform integrators needing
    unified food ordering and delivery dispatch.
  tags:
  - Uber
  - Uber Eats
  - Uber Direct
  - Food Delivery
  - Delivery
  - Logistics
  - Restaurants
  created: '2026-05-03'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    UBER_EATS_ACCESS_TOKEN: UBER_EATS_ACCESS_TOKEN
    UBER_DIRECT_ACCESS_TOKEN: UBER_DIRECT_ACCESS_TOKEN
capability:
  consumes:
  - type: http
    namespace: uber-eats
    baseUri: https://api.uber.com/v1
    description: Uber Eats Marketplace API for store, menu, and order management.
    authentication:
      type: bearer
      token: '{{UBER_EATS_ACCESS_TOKEN}}'
    resources:
    - name: stores
      path: /eats/stores
      description: Uber Eats store management.
      operations:
      - name: list-stores
        method: GET
        description: Returns a list of stores for the authenticated partner.
        inputParameters:
        - name: limit
          in: query
          type: integer
          required: false
          description: Number of stores to return.
        - name: offset
          in: query
          type: integer
          required: false
          description: Pagination offset.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: store
      path: /eats/stores/{store_id}
      description: Individual store operations.
      operations:
      - name: get-store
        method: GET
        description: Returns details for a specific store.
        inputParameters:
        - name: store_id
          in: path
          type: string
          required: true
          description: Unique identifier for the store.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: store-menu
      path: /eats/stores/{store_id}/menus
      description: Store menu management.
      operations:
      - name: get-store-menu
        method: GET
        description: Returns the current menu for a specific store.
        inputParameters:
        - name: store_id
          in: path
          type: string
          required: true
          description: Unique identifier for the store.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: update-store-menu
        method: PUT
        description: Replace the full menu for a specific store.
        inputParameters:
        - name: store_id
          in: path
          type: string
          required: true
          description: Unique identifier for the store.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            categories: '{{tools.categories}}'
    - name: order
      path: /eats/orders/{order_id}
      description: Individual order operations.
      operations:
      - name: get-order
        method: GET
        description: Returns order details for a specific order ID.
        inputParameters:
        - name: order_id
          in: path
          type: string
          required: true
          description: Unique identifier for the order.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: accept-order
      path: /eats/orders/{order_id}/accept_pos_order
      description: Order acceptance.
      operations:
      - name: accept-order
        method: POST
        description: Accept a pending order within the required acceptance window.
        inputParameters:
        - name: order_id
          in: path
          type: string
          required: true
          description: Unique identifier for the order.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: deny-order
      path: /eats/orders/{order_id}/deny_pos_order
      description: Order denial.
      operations:
      - name: deny-order
        method: POST
        description: Deny a pending order.
        inputParameters:
        - name: order_id
          in: path
          type: string
          required: true
          description: Unique identifier for the order.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            reason: '{{tools.reason}}'
  - type: http
    namespace: uber-direct
    baseUri: https://api.uber.com/v1
    description: Uber Direct delivery API for on-demand courier dispatching.
    authentication:
      type: bearer
      token: '{{UBER_DIRECT_ACCESS_TOKEN}}'
    resources:
    - name: delivery-quote
      path: /eats/deliveries/quote
      description: Delivery price quotes.
      operations:
      - name: get-delivery-quote
        method: POST
        description: Get a price quote for a delivery before creating the order.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            pickup_address: '{{tools.pickup_address}}'
            dropoff_address: '{{tools.dropoff_address}}'
    - name: deliveries
      path: /eats/deliveries
      description: Delivery order creation.
      operations:
      - name: create-delivery
        method: POST
        description: Create a new delivery request using Uber's courier network.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            pickup_name: '{{tools.pickup_name}}'
            pickup_address: '{{tools.pickup_address}}'
            dropoff_name: '{{tools.dropoff_name}}'
            dropoff_address: '{{tools.dropoff_address}}'
    - name: delivery
      path: /eats/deliveries/{order_id}
      description: Individual delivery order management.
      operations:
      - name: get-delivery
        method: GET
        description: Returns the current status of a delivery order.
        inputParameters:
        - name: order_id
          in: path
          type: string
          required: true
          description: Unique identifier for the delivery order.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: cancel-delivery
        method: DELETE
        description: Cancel an active delivery order.
        inputParameters:
        - name: order_id
          in: path
          type: string
          required: true
          description: Unique identifier for the delivery order.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: business-locations
      path: /business-locations
      description: Business pickup location management.
      operations:
      - name: list-business-locations
        method: GET
        description: Returns all business locations for the authenticated merchant.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-business-location
        method: POST
        description: Create a new business pickup location.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            name: '{{tools.name}}'
            address: '{{tools.address}}'
  exposes:
  - type: rest
    port: 8081
    namespace: uber-food-delivery-api
    description: Unified REST API for Uber Eats store management and Uber Direct delivery operations.
    resources:
    - path: /v1/stores
      name: stores
      description: Uber Eats store listings.
      operations:
      - method: GET
        name: list-stores
        description: List all stores for the authenticated Uber Eats partner.
        call: uber-eats.list-stores
        with:
          limit: rest.limit
          offset: rest.offset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/stores/{store_id}
      name: store
      description: Individual Uber Eats store details.
      operations:
      - method: GET
        name: get-store
        description: Get details for a specific Uber Eats store.
        call: uber-eats.get-store
        with:
          store_id: rest.store_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/stores/{store_id}/menu
      name: store-menu
      description: Uber Eats store menu management.
      operations:
      - method: GET
        name: get-store-menu
        description: Get the current menu for a store.
        call: uber-eats.get-store-menu
        with:
          store_id: rest.store_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/orders/{order_id}
      name: order
      description: Uber Eats order management.
      operations:
      - method: GET
        name: get-order
        description: Get details for a specific Uber Eats order.
        call: uber-eats.get-order
        with:
          order_id: rest.order_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deliveries/quotes
      name: delivery-quotes
      description: Uber Direct delivery price quotes.
      operations:
      - method: POST
        name: get-delivery-quote
        description: Get a price quote for an on-demand delivery.
        call: uber-direct.get-delivery-quote
        with:
          pickup_address: rest.pickup_address
          dropoff_address: rest.dropoff_address
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deliveries
      name: deliveries
      description: Uber Direct delivery dispatch.
      operations:
      - method: POST
        name: create-delivery
        description: Dispatch an Uber courier for on-demand delivery.
        call: uber-direct.create-delivery
        with:
          pickup_name: rest.pickup_name
          pickup_address: rest.pickup_address
          dropoff_name: rest.dropoff_name
          dropoff_address: rest.dropoff_address
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deliveries/{order_id}
      name: delivery
      description: Individual Uber Direct delivery tracking and management.
      operations:
      - method: GET
        name: get-delivery
        description: Get the current status of a delivery order.
        call: uber-direct.get-delivery
        with:
          order_id: rest.order_id
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: cancel-delivery
        description: Cancel an active delivery order.
        call: uber-direct.cancel-delivery
        with:
          order_id: rest.order_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/pickup-locations
      name: pickup-locations
      description: Business pickup location management for Uber Direct.
      operations:
      - method: GET
        name: list-pickup-locations
        description: List all business pickup locations.
        call: uber-direct.list-business-locations
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9091
    namespace: uber-food-delivery-mcp
    transport: http
    description: MCP server for AI-assisted food ordering and delivery dispatch.
    tools:
    - name: list-eats-stores
      description: List all Uber Eats stores for the partner account.
      hints:
        readOnly: true
        openWorld: false
      call: uber-eats.list-stores
      with:
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: get-eats-store
      description: Get details for a specific Uber Eats restaurant store.
      hints:
        readOnly: true
        openWorld: false
      call: uber-eats.get-store
      with:
        store_id: tools.store_id
      outputParameters:
      - type: object
        mapping: $.
    - name: get-store-menu
      description: Get the current menu for an Uber Eats store.
      hints:
        readOnly: true
        openWorld: false
      call: uber-eats.get-store-menu
      with:
        store_id: tools.store_id
      outputParameters:
      - type: object
        mapping: $.
    - name: get-eats-order
      description: Get details for an Uber Eats order.
      hints:
        readOnly: true
        openWorld: false
      call: uber-eats.get-order
      with:
        order_id: tools.order_id
      outputParameters:
      - type: object
        mapping: $.
    - name: accept-eats-order
      description: Accept a pending Uber Eats order.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: uber-eats.accept-order
      with:
        order_id: tools.order_id
      outputParameters:
      - type: object
        mapping: $.
    - name: deny-eats-order
      description: Deny a pending Uber Eats order with a reason.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: uber-eats.deny-order
      with:
        order_id: tools.order_id
        reason: tools.reason
      outputParameters:
      - type: object
        mapping: $.
    - name: quote-direct-delivery
      description: Get a price quote for an Uber Direct on-demand delivery.
      hints:
        readOnly: true
        openWorld: true
      call: uber-direct.get-delivery-quote
      with:
        pickup_address: tools.pickup_address
        dropoff_address: tools.dropoff_address
      outputParameters:
      - type: object
        mapping: $.
    - name: create-direct-delivery
      description: Dispatch an Uber courier for an on-demand delivery.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: uber-direct.create-delivery
      with:
        pickup_name: tools.pickup_name
        pickup_address: tools.pickup_address
        dropoff_name: tools.dropoff_name
        dropoff_address: tools.dropoff_address
      outputParameters:
      - type: object
        mapping: $.
    - name: track-direct-delivery
      description: Track the real-time status of an Uber Direct delivery.
      hints:
        readOnly: true
        openWorld: false
      call: uber-direct.get-delivery
      with:
        order_id: tools.order_id
      outputParameters:
      - type: object
        mapping: $.
    - name: cancel-direct-delivery
      description: Cancel an active Uber Direct delivery.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: uber-direct.cancel-delivery
      with:
        order_id: tools.order_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-pickup-locations
      description: List business pickup locations configured for Uber Direct.
      hints:
        readOnly: true
        openWorld: false
      call: uber-direct.list-business-locations
      outputParameters:
      - type: object
        mapping: $.