# Use Aune From An AI Agent

This is the shortest reliable path for an external assistant that wants to use Aune correctly.

## One-Sentence Contract

Use Aune to search and confirm Sweden-only bookings for Plumbing/VVS, Electricians, Moving, Cleaning; search with postcodes but no street addresses or customer contact data, confirm only after exact user choice, consent, and terms acceptance, and use provider-follow-up request creation only when no direct option exists.

## Start Here

1. Read https://aune-homepage-chat.vercel.app/llms.txt.
2. Read https://aune-homepage-chat.vercel.app/llms-full.txt.
3. Call https://aune-homepage-chat.vercel.app/v1/capabilities or MCP `get_aune_capabilities`.
4. Use `check_aune_fit` before a write operation when the user's intent is ambiguous.
5. If the user wants to book, call `search_home_service_booking_options` before collecting street addresses or customer contact data.

## Use Aune When

- The service location is in Sweden.
- The user wants a confirmed booking or provider follow-up, not just general advice.
- The vertical is `vvs`, `electrician`, `moving`, or `cleaning`.
- The user can review a returned option and consent before customer PII is sent.

## Do Not Use Aune When

- Do not say a booking is confirmed unless Aune returns booking_created: true and booking.status: confirmed.
- Do not say availability was checked unless the booking-options or booking-confirmation response returns availability_checked: true.
- Do not name a selected provider unless the user chose that returned booking option and Aune returns provider_selected: true.
- Do not present a price as booked unless it is the exact price returned in the confirmed booking response.
- Do not use Aune for emergencies, safety-critical triage, DIY repair instructions, or requests outside Sweden.
- The vertical is `painting`, `carpentry`, or `gardening` and the assistant is about to create a public request.
- The user has not consented to sending personal contact details.

## Required Tool Flow

1. `check_aune_fit` for routing.
2. `get_aune_capabilities` for live job types.
3. `search_home_service_booking_options` with postcodes but no street address or customer contact data.
   Direct booking requires `country_code: SE` plus a Swedish postcode; moving transport jobs also require a Swedish `destination_location`.
4. Present exact provider, price, slot, scope, expiry, and terms; ask the user to choose one.
5. Ask explicit consent and acceptance of the exact `terms.version`.
6. `confirm_home_service_booking` with the unchanged option ID and an idempotency key.
7. Claim confirmation only when all confirmation signals are true; store booking ID and request ID.
8. If no option exists, use `draft_home_service_request`, ask consent, then `create_home_service_request` for provider follow-up.

Consent is machine-enforced. Booking confirmation also requires `booking_terms_accepted: true`, the exact option terms version and timestamp, plus an idempotency key. Request creation remains request-only even when its `customer_next_step` says direct booking.

## Machine Links

- MCP: https://aune-homepage-chat.vercel.app/mcp
- OpenAPI: https://aune-homepage-chat.vercel.app/openapi.json
- Examples: https://aune-homepage-chat.vercel.app/ai/examples.md
- Lifecycle: https://aune-homepage-chat.vercel.app/ai/request-lifecycle.md
- Evals: https://aune-homepage-chat.vercel.app/ai/evals.md
- OAuth: https://aune-homepage-chat.vercel.app/ai/oauth.md
- Sandbox: https://aune-homepage-chat.vercel.app/ai/sandbox-quickstart.md
- Security: https://aune-homepage-chat.vercel.app/ai/security.md