MCP Tool

request_delivery

Create a delivery request and let daily.delivery route it to the best available provider.

request_delivery(pickup, dropoff, package_type, urgency, max_cost)

Input Schema

Property	Type	Description
pickup	object	{ address, lat?, lng? }
dropoff	object	{ address, lat?, lng? }
package_type	string	enum: 'small', 'medium', 'large'
urgency	string	enum: 'standard', 'express', default 'standard'
max_cost	number	max USD willing to pay

Success Envelope

{
  "delivery_id": "del_8f32ab91",
  "provider": "RelayNow",
  "eta_minutes": 34,
  "cost_usd": 12.75,
  "tracking_url": "https://daily.delivery/track/del_8f32ab91",
  "status": "requested"
}

Error Envelope

{
  "error": {
    "message": "No provider can satisfy the requested delivery constraints.",
    "retryable": true,
    "retry_after_seconds": 120,
    "suggested_action": "Relax urgency, increase max_cost, or retry after provider capacity refreshes."
  }
}

MCP Tool

get_quote

Return provider pricing and ETA without committing to a delivery request.

get_quote(pickup, dropoff, package_type, urgency?)

Input Schema

Property	Type	Description
pickup	object	{ address, lat?, lng? }
dropoff	object	{ address, lat?, lng? }
package_type	string	enum: 'small', 'medium', 'large'
urgency	string	enum: 'standard', 'express', default 'standard'

Success Envelope

{
  "delivery_id": null,
  "provider": "RelayNow",
  "eta_minutes": 34,
  "cost_usd": 12.75,
  "tracking_url": null,
  "status": "quoted"
}

Error Envelope

{
  "error": {
    "message": "Quote capacity is temporarily unavailable for this route.",
    "retryable": true,
    "retry_after_seconds": 90,
    "suggested_action": "Retry with standard urgency or request a nearby pickup window."
  }
}

MCP Tool

track_delivery

Fetch the latest delivery status, provider assignment, ETA, cost, and tracking URL.

track_delivery(delivery_id)

Input Schema

Property	Type	Description
delivery_id	string	UUID

Success Envelope

{
  "delivery_id": "del_8f32ab91",
  "provider": "RelayNow",
  "eta_minutes": 34,
  "cost_usd": 12.75,
  "tracking_url": "https://daily.delivery/track/del_8f32ab91",
  "status": "in_transit"
}

Error Envelope

{
  "error": {
    "message": "Delivery was not found or is no longer visible to this API key.",
    "retryable": false,
    "retry_after_seconds": 0,
    "suggested_action": "Verify the delivery_id and API key scope before retrying."
  }
}

MCP Tool

cancel_delivery

Cancel a delivery that has not passed the provider handoff cutoff.

cancel_delivery(delivery_id, reason?)

Input Schema

Property	Type	Description
delivery_id	string	UUID
reason	string	cancellation reason

Success Envelope

{
  "delivery_id": "del_8f32ab91",
  "provider": "RelayNow",
  "eta_minutes": 0,
  "cost_usd": 12.75,
  "tracking_url": "https://daily.delivery/track/del_8f32ab91",
  "status": "cancelled"
}

Error Envelope

{
  "error": {
    "message": "Delivery can no longer be cancelled after provider pickup.",
    "retryable": false,
    "retry_after_seconds": 0,
    "suggested_action": "Track the delivery or contact support for exception handling."
  }
}