This quickstart uses the public edge surface. MCP clients use /mcp; direct HTTP clients use /tools/:name with x402 payment.

1. Set your endpoints

export SENDERO_EDGE_URL="https://edge.sendero.travel"
export SENDERO_APP_URL="https://app.sendero.travel"
export SENDERO_API_KEY="ak_..."

2. Read the agent manifest

Agents should start with llms.txt before calling tools:

curl $SENDERO_EDGE_URL/.well-known/llms.txt

The manifest points to the current docs, tool catalog, MCP endpoint, paid HTTP tool surface, and safety rules.

3. List MCP tools

curl -X POST $SENDERO_EDGE_URL/mcp \
  -H "content-type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

Use MCP when your host wants JSON schemas before selecting tools.

4. Get an x402 quote

Direct HTTP tools are paid per successful call. First call without a Payment-Signature header:

curl -i -X POST $SENDERO_EDGE_URL/tools/check_treasury \
  -H "content-type: application/json" \
  -H "authorization: Bearer $SENDERO_API_KEY" \
  -d '{}'

Sendero returns 402 Payment Required with a PAYMENT-REQUIRED header. Decode that header, sign the EIP-3009 authorization with your wallet, then retry with:

curl -X POST $SENDERO_EDGE_URL/tools/check_treasury \
  -H "content-type: application/json" \
  -H "authorization: Bearer $SENDERO_API_KEY" \
  -H "Payment-Signature: $BASE64_X402_PAYMENT" \
  -d '{}'

The response includes the tool result plus payment metadata.

5. Search flights

curl -X POST $SENDERO_EDGE_URL/tools/search_flights \
  -H "content-type: application/json" \
  -H "authorization: Bearer $SENDERO_API_KEY" \
  -H "Payment-Signature: $BASE64_X402_PAYMENT" \
  -d '{
    "origin": "SFO",
    "destination": "LHR",
    "departureDate": "2026-06-11",
    "passengers": 1,
    "cabinClass": "economy"
  }'

6. Delegate the full booking

For production bookings, prefer the workflow API instead of chaining tools manually:

curl -X POST $SENDERO_APP_URL/api/workflows/run \
  -H "content-type: application/json" \
  -H "authorization: Bearer $SENDERO_INTERNAL_TOKEN" \
  -d '{
    "workflowId": "sendero.book_flight",
    "tenantId": "tenant_acme",
    "userId": "traveler_ada",
    "input": {
      "tripId": "0x...",
      "origin": "SFO",
      "destination": "LHR",
      "departureDate": "2026-06-11",
      "passengers": 1,
      "cabinClass": "economy",
      "policyId": "policy_default"
    }
  }'

The workflow handles search, policy, escrow reservation, hold, ticketing pause, settlement, and invoice generation. Continue with agent-to-agent booking.

Quickstart