naftiko: 1.0.0-alpha2
info:
  label: Uber Ride Management
  description: Workflow capability for managing the complete Uber ride lifecycle. Combines the Riders API (ride requests,
    estimates, products) and Drivers API (driver profile, trips, payments) to support ride-booking applications, fleet management
    dashboards, and driver analytics tools.
  tags:
  - Uber
  - Ride-Sharing
  - Transportation
  - Riders
  - Drivers
  created: '2026-05-03'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    UBER_RIDERS_ACCESS_TOKEN: UBER_RIDERS_ACCESS_TOKEN
    UBER_DRIVERS_ACCESS_TOKEN: UBER_DRIVERS_ACCESS_TOKEN
capability:
  consumes:
  - type: http
    namespace: uber-riders
    baseUri: https://api.uber.com/v1.2
    description: Uber Riders API for ride requests, products, and estimates.
    authentication:
      type: bearer
      token: '{{UBER_RIDERS_ACCESS_TOKEN}}'
    resources:
    - name: products
      path: /products
      description: Uber product types available at a location.
      operations:
      - name: list-products
        method: GET
        description: Returns information about the Uber products offered at a given location.
        inputParameters:
        - name: latitude
          in: query
          type: number
          required: true
          description: Latitude component of location.
        - name: longitude
          in: query
          type: number
          required: true
          description: Longitude component of location.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: product
      path: /products/{product_id}
      description: Specific Uber product details.
      operations:
      - name: get-product
        method: GET
        description: Returns information about a specific Uber product.
        inputParameters:
        - name: product_id
          in: path
          type: string
          required: true
          description: Unique identifier for the product.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: price-estimates
      path: /estimates/price
      description: Price estimates for ride products.
      operations:
      - name: get-price-estimates
        method: GET
        description: Returns an estimated price range for each product between two locations.
        inputParameters:
        - name: start_latitude
          in: query
          type: number
          required: true
          description: Start location latitude.
        - name: start_longitude
          in: query
          type: number
          required: true
          description: Start location longitude.
        - name: end_latitude
          in: query
          type: number
          required: true
          description: End location latitude.
        - name: end_longitude
          in: query
          type: number
          required: true
          description: End location longitude.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: time-estimates
      path: /estimates/time
      description: ETA estimates for ride products.
      operations:
      - name: get-time-estimates
        method: GET
        description: Returns ETAs for all products offered at a given location.
        inputParameters:
        - name: start_latitude
          in: query
          type: number
          required: true
          description: Start location latitude.
        - name: start_longitude
          in: query
          type: number
          required: true
          description: Start location longitude.
        - name: product_id
          in: query
          type: string
          required: false
          description: Filter by product ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: rider-profile
      path: /me
      description: Authenticated rider profile.
      operations:
      - name: get-rider-profile
        method: GET
        description: Returns the authenticated rider's Uber profile.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: ride-history
      path: /history
      description: Rider's trip history.
      operations:
      - name: get-ride-history
        method: GET
        description: Returns the rider's lifetime activity with Uber.
        inputParameters:
        - name: limit
          in: query
          type: integer
          required: false
          description: Number of items to return.
        - name: offset
          in: query
          type: integer
          required: false
          description: Pagination offset.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: ride-requests
      path: /requests
      description: Ride request management.
      operations:
      - name: create-ride-estimate
        method: POST
        description: Get an upfront fare estimate before booking a ride.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            product_id: '{{tools.product_id}}'
            start_latitude: '{{tools.start_latitude}}'
            start_longitude: '{{tools.start_longitude}}'
            end_latitude: '{{tools.end_latitude}}'
            end_longitude: '{{tools.end_longitude}}'
      - name: create-ride-request
        method: POST
        description: Request a ride on behalf of an Uber user.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            product_id: '{{tools.product_id}}'
            start_latitude: '{{tools.start_latitude}}'
            start_longitude: '{{tools.start_longitude}}'
            end_latitude: '{{tools.end_latitude}}'
            end_longitude: '{{tools.end_longitude}}'
            fare_id: '{{tools.fare_id}}'
    - name: ride-request
      path: /requests/{request_id}
      description: Individual ride request operations.
      operations:
      - name: get-ride-request
        method: GET
        description: Get real-time status of an ongoing trip.
        inputParameters:
        - name: request_id
          in: path
          type: string
          required: true
          description: Unique identifier for the ride request.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: cancel-ride-request
        method: DELETE
        description: Cancel an ongoing ride request.
        inputParameters:
        - name: request_id
          in: path
          type: string
          required: true
          description: Unique identifier for the ride request.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  - type: http
    namespace: uber-drivers
    baseUri: https://api.uber.com/v1
    description: Uber Drivers API for partner profile, payments, and trip data.
    authentication:
      type: bearer
      token: '{{UBER_DRIVERS_ACCESS_TOKEN}}'
    resources:
    - name: driver-profile
      path: /partners/me
      description: Driver partner profile.
      operations:
      - name: get-driver-profile
        method: GET
        description: Returns information about the authenticated driver partner.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: driver-payments
      path: /partners/payments
      description: Driver payment history.
      operations:
      - name: get-driver-payments
        method: GET
        description: Returns a list of payments made to the driver.
        inputParameters:
        - name: from_time
          in: query
          type: integer
          required: false
          description: Start of query time range (Unix timestamp).
        - name: to_time
          in: query
          type: integer
          required: false
          description: End of query time range (Unix timestamp).
        - name: limit
          in: query
          type: integer
          required: false
          description: Number of items to return.
        - name: offset
          in: query
          type: integer
          required: false
          description: Pagination offset.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: driver-trips
      path: /partners/trips
      description: Driver trip history.
      operations:
      - name: get-driver-trips
        method: GET
        description: Returns trip history for the authenticated driver partner.
        inputParameters:
        - name: from_time
          in: query
          type: integer
          required: false
          description: Start of query time range (Unix timestamp).
        - name: to_time
          in: query
          type: integer
          required: false
          description: End of query time range (Unix timestamp).
        - name: limit
          in: query
          type: integer
          required: false
          description: Number of items to return.
        - name: offset
          in: query
          type: integer
          required: false
          description: Pagination offset.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: uber-ride-management-api
    description: Unified REST API for managing Uber ride requests, estimates, and driver data.
    resources:
    - path: /v1/products
      name: products
      description: Available Uber ride products at a location.
      operations:
      - method: GET
        name: list-products
        description: List Uber products available at a given location.
        call: uber-riders.list-products
        with:
          latitude: rest.latitude
          longitude: rest.longitude
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/estimates/price
      name: price-estimates
      description: Price estimates for rides between two locations.
      operations:
      - method: GET
        name: get-price-estimates
        description: Get price estimates for available products between two points.
        call: uber-riders.get-price-estimates
        with:
          start_latitude: rest.start_latitude
          start_longitude: rest.start_longitude
          end_latitude: rest.end_latitude
          end_longitude: rest.end_longitude
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/estimates/time
      name: time-estimates
      description: ETA estimates for ride products at a pickup location.
      operations:
      - method: GET
        name: get-time-estimates
        description: Get arrival time estimates for available products.
        call: uber-riders.get-time-estimates
        with:
          start_latitude: rest.start_latitude
          start_longitude: rest.start_longitude
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/ride-requests
      name: ride-requests
      description: Ride request creation and management.
      operations:
      - method: POST
        name: create-ride-request
        description: Request a ride for an authenticated Uber user.
        call: uber-riders.create-ride-request
        with:
          product_id: rest.product_id
          start_latitude: rest.start_latitude
          start_longitude: rest.start_longitude
          end_latitude: rest.end_latitude
          end_longitude: rest.end_longitude
          fare_id: rest.fare_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/ride-requests/{request_id}
      name: ride-request
      description: Individual ride request status and cancellation.
      operations:
      - method: GET
        name: get-ride-request
        description: Get real-time status of a ride request.
        call: uber-riders.get-ride-request
        with:
          request_id: rest.request_id
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: cancel-ride-request
        description: Cancel an active ride request.
        call: uber-riders.cancel-ride-request
        with:
          request_id: rest.request_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/riders/profile
      name: rider-profile
      description: Authenticated rider profile.
      operations:
      - method: GET
        name: get-rider-profile
        description: Get the authenticated rider's Uber profile.
        call: uber-riders.get-rider-profile
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/riders/history
      name: ride-history
      description: Rider trip history.
      operations:
      - method: GET
        name: get-ride-history
        description: Get the rider's trip history.
        call: uber-riders.get-ride-history
        with:
          limit: rest.limit
          offset: rest.offset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/drivers/profile
      name: driver-profile
      description: Authenticated driver partner profile.
      operations:
      - method: GET
        name: get-driver-profile
        description: Get the authenticated driver partner's profile.
        call: uber-drivers.get-driver-profile
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/drivers/payments
      name: driver-payments
      description: Driver payment history.
      operations:
      - method: GET
        name: get-driver-payments
        description: Get payment history for the driver partner.
        call: uber-drivers.get-driver-payments
        with:
          from_time: rest.from_time
          to_time: rest.to_time
          limit: rest.limit
          offset: rest.offset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/drivers/trips
      name: driver-trips
      description: Driver trip history.
      operations:
      - method: GET
        name: get-driver-trips
        description: Get trip history for the driver partner.
        call: uber-drivers.get-driver-trips
        with:
          from_time: rest.from_time
          to_time: rest.to_time
          limit: rest.limit
          offset: rest.offset
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: uber-ride-management-mcp
    transport: http
    description: MCP server for AI-assisted Uber ride booking and driver analytics.
    tools:
    - name: list-uber-products
      description: List available Uber ride products at a specific location.
      hints:
        readOnly: true
        openWorld: true
      call: uber-riders.list-products
      with:
        latitude: tools.latitude
        longitude: tools.longitude
      outputParameters:
      - type: object
        mapping: $.
    - name: get-price-estimates
      description: Get price estimates for Uber rides between two locations.
      hints:
        readOnly: true
        openWorld: true
      call: uber-riders.get-price-estimates
      with:
        start_latitude: tools.start_latitude
        start_longitude: tools.start_longitude
        end_latitude: tools.end_latitude
        end_longitude: tools.end_longitude
      outputParameters:
      - type: object
        mapping: $.
    - name: get-time-estimates
      description: Get estimated arrival times for Uber products at a pickup location.
      hints:
        readOnly: true
        openWorld: true
      call: uber-riders.get-time-estimates
      with:
        start_latitude: tools.start_latitude
        start_longitude: tools.start_longitude
      outputParameters:
      - type: object
        mapping: $.
    - name: create-ride-request
      description: Request an Uber ride for a user.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: uber-riders.create-ride-request
      with:
        product_id: tools.product_id
        start_latitude: tools.start_latitude
        start_longitude: tools.start_longitude
        end_latitude: tools.end_latitude
        end_longitude: tools.end_longitude
        fare_id: tools.fare_id
      outputParameters:
      - type: object
        mapping: $.
    - name: get-ride-status
      description: Get the real-time status of an active ride request.
      hints:
        readOnly: true
        openWorld: false
      call: uber-riders.get-ride-request
      with:
        request_id: tools.request_id
      outputParameters:
      - type: object
        mapping: $.
    - name: cancel-ride
      description: Cancel an active Uber ride request.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: uber-riders.cancel-ride-request
      with:
        request_id: tools.request_id
      outputParameters:
      - type: object
        mapping: $.
    - name: get-rider-profile
      description: Get the authenticated Uber rider's profile information.
      hints:
        readOnly: true
        openWorld: false
      call: uber-riders.get-rider-profile
      outputParameters:
      - type: object
        mapping: $.
    - name: get-rider-history
      description: Get the trip history for an Uber rider.
      hints:
        readOnly: true
        openWorld: false
      call: uber-riders.get-ride-history
      with:
        limit: tools.limit
        offset: tools.offset
      outputParameters:
      - type: object
        mapping: $.
    - name: get-driver-profile
      description: Get the profile for an Uber driver partner.
      hints:
        readOnly: true
        openWorld: false
      call: uber-drivers.get-driver-profile
      outputParameters:
      - type: object
        mapping: $.
    - name: get-driver-payments
      description: Get payment history for an Uber driver partner.
      hints:
        readOnly: true
        openWorld: false
      call: uber-drivers.get-driver-payments
      with:
        from_time: tools.from_time
        to_time: tools.to_time
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: get-driver-trips
      description: Get trip history for an Uber driver partner.
      hints:
        readOnly: true
        openWorld: false
      call: uber-drivers.get-driver-trips
      with:
        from_time: tools.from_time
        to_time: tools.to_time
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.