A priced hand-carry quote, in one call

How a quote is produced

1. 1. Live fare search. Real airline offers for the requested city pair, never an estimate.
2. 2. Routing agent. Selects the flight that works operationally: cabin baggage only, no connection under 90 minutes, enough time between pickup and departure, arrival inside your deadline.
3. 3. Fixed rate card. The price is computed by a rules engine, not by a model. Same inputs, same price, every time.
4. 4. Verification agent. A second, independent model on the same data, without seeing the first one's reasoning, whose job is to find the flaw in the selection.
5. 5. Hard checks. Connection times, lead time, deadline and a full recomputation of the price. These run last and nothing overrides them.

An offer is only sent when every one of those agrees. Anything else is routed to a human at our desk, and the API answers needs_review instead of a price we cannot stand behind.

POST /api/v1/quote

Synchronous by default. Send "async": true to get the reference immediately and let the customer receive the offer by email.

curl -X POST https://api.onboardcourier.ae/api/v1/quote \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: <your key>" \
  -d '{
    "name": "Aisha Khan",
    "email": "aisha@example.com",
    "phone": "+971500000000",
    "origin": "DXB",
    "destination": "FRA",
    "ready_at": "2026-09-04T08:00",
    "deadline_at": "2026-09-05T18:00",
    "weight_kg": 4.5,
    "pieces": 1,
    "goods": "Aircraft AOG part, boxed",
    "pickup_location": "Jebel Ali Free Zone",
    "delivery_location": "Frankfurt Airport, Cargo City Sued"
  }'

{
  "reference": "QK3M9TX2QP4",
  "status": "offered",
  "total": 8940,
  "currency": "AED",
  "valid_until": "2026-09-01T11:47:12.000Z",
  "valid_for_minutes": 60,
  "message": "The offer has been emailed to aisha@example.com."
}

Status and acceptance

• GET /api/v1/quote?reference=Q... returns the current state of one request. Requires your API key.
• The customer accepts through the link in the offer email. We reconfirm the fare with the airline at that moment. If it moved by more than three percent, the offer is withdrawn and re-issued rather than silently repriced.
• Statuses: offered, needs_review, accepted, expired, failed.

For AI agents

The same engine is exposed over the Model Context Protocol, so an agent can call it as a tool instead of being taught an HTTP contract. Stateless streamable HTTP, three tools, a partner key on every call.

• quote_hand_carry_shipment creates a real lead and sends a real email. It is not a lookup.
• check_quote_status and list_served_airports are read only.
• There is deliberately no tool that accepts an offer. Acceptance happens through the link in the customer's own email, which is also the consent trail.

# Claude Code
claude mcp add --transport http onboardcourier \
  https://api.onboardcourier.ae/mcp \
  --header "X-Api-Key: <your key>"

# Any MCP client, by configuration
{
  "mcpServers": {
    "onboardcourier": {
      "type": "http",
      "url": "https://api.onboardcourier.ae/mcp",
      "headers": { "X-Api-Key": "<your key>" }
    }
  }
}