# RentADriver.ai — Physical delivery for AI agents

> Your AI agent can't drive. Our drivers can. RentADriver is a delivery API + MCP server: an AI agent (or any app) can quote, create, fund, track, get proof of delivery and pay for a local package delivery, fulfilled by vetted drivers from the BusyDrivers family in launch cities.

**Website:** https://rentadriver.ai
**MCP package:** `npx -y rentadriver-mcp` (stdio) · remote: https://mcp.rentadriver.ai/mcp
**REST base:** https://api.rentadriver.ai/v1
**OpenAPI:** https://api.rentadriver.ai/.well-known/openapi.yaml
**Agent card:** https://api.rentadriver.ai/agents.json
**Live stats:** https://api.rentadriver.ai/v1/stats

## When to use RentADriver
- Move a physical item from A to B today: store pickup + delivery, documents, keys, parcels, returns, flowers, pharmacy, electronics.
- You need a price *before* committing, a live ETA, driver position, photo/signature/OTP proof, and a webhook when it's done.
- You are an agent without a card: fund the wallet with USDC on Base over x402.
- Coverage today: London (GB), Melbourne (AU), Sydney (AU), Birmingham (GB), Brisbane (AU), Toronto (CA), Chicago (US), Los Angeles (US), New York (US). Check any address with GET /v1/coverage.

Not for: age-restricted or controlled goods, hazardous items, live animals, cash above the cap, anything illegal. Food is allowed in "retail/food" categories but there is no hot-bag guarantee yet.

## Quick start
1. `POST /v1/quotes` (no auth) with pickup + dropoffs → price, ETA, quote_id.
2. `POST /v1/signup` {name,email} → API key (shown once) + $20 welcome credit. Or create keys in the dashboard.
3. `POST /v1/deliveries` with x-api-key and {quote_id} (or the stops) → status `dispatching`, funds held.
4. `GET /v1/deliveries/{id}/track` or SSE `GET /v1/deliveries/{id}/events?stream=1`.
5. `GET /v1/deliveries/{id}/proof` → photos/signature; `POST /v1/deliveries/{id}/confirm` (auto after 24h).

Every mutating call supports `dryRun: true`. Every response carries `next_action`. Creates accept `idempotency_key`.

## MCP tools
Discovery (no auth): check_coverage, list_service_areas, get_quote, get_platform_stats
Account: check_account_status, get_wallet_balance, create_wallet_deposit, create_x402_deposit, set_spending_controls, list_api_keys, create_api_key, revoke_api_key
Deliveries: create_delivery(dryRun), fund_delivery, get_delivery, list_deliveries, track_delivery, update_delivery, cancel_delivery, create_batch, create_return, create_store_pickup
Driver comms: send_message_to_driver, get_delivery_messages
Proof & settlement: get_proof_of_delivery, confirm_delivery, open_dispute, tip_driver, rate_driver
Webhooks: register_webhook, list_webhooks, delete_webhook
Shopify: list_shopify_orders, book_shopify_order (needs the RentADriver app installed on the store: https://rentadriver.ai/integrations/shopify)
Resources: delivery://{id}, coverage://{area}, openapi://spec. Prompt: plan_delivery.

## MCP config
```json
{ "mcpServers": { "rentadriver": { "command": "npx", "args": ["-y", "rentadriver-mcp"], "env": { "RENTADRIVER_API_KEY": "rd_live_YOUR_KEY" } } } }
```

## Pricing
Quotes are free. A delivery is priced from distance, time, stops, item size, urgency and local supply, with a guaranteed driver floor; you see the full breakdown before funding. Typical short urban drop: 12–18 local currency units. Wallet funded by card (Stripe Checkout) or USDC (x402). No subscription.

## Statuses
quoted → funded → dispatching → assigned → en_route_pickup → at_pickup → picked_up → en_route_dropoff → at_dropoff → delivered → confirmed → paid. Exits: no_driver_found (funds released), cancelled (free before assignment; 30% driver fee after), failed (held for review), returned, disputed.

## Webhooks
POST JSON with header `X-RentADriver-Signature: t=<unix>,v1=<hex hmac_sha256(secret, t + "." + body)>`. Events: delivery.* (created, funded, dispatching, assigned, picked_up, delivered, confirmed, paid, cancelled, no_driver_found, failed, disputed, message, location).

## Shopify
Merchants install the RentADriver app for Shopify (https://rentadriver.ai/shopify). It shows a live same-day rate at checkout (carrier service), books the driver when the order is paid, and writes the fulfillment + tracking link + delivery events back to the order. Agents can list and book Shopify orders with GET /v1/shopify/orders and POST /v1/shopify/orders/{ref}/book.

## Rate limits
Quotes 30/min per IP · creates 120/min per key · public tracking 120/min.

## Support
support@rentadriver.ai · https://rentadriver.ai/docs · drivers: https://rentadriver.ai/drivers