search_aune_docs
Retrieve current canonical guidance, recovery rules, and contract versions.
Aune MCP
Remote tools that finish the booking.
Aune exposes a remote MCP endpoint for assistants that need to search real provider, price, and slot options, confirm the user's exact choice, and fall back to provider follow-up when needed.
Base URLhttps://aune-homepage-chat.vercel.app
Endpoint/mcp
Contractaune_mcp_v3
Protocol2025-06-18
AuthOAuth 2.1 scopes
Write guardConsent + exact terms + idempotency
Recommended flow
Search before sending contact details.
The MCP surface separates read-only option discovery from the authenticated commitment that creates a confirmed booking.
check_aune_fit
Decide whether Aune is appropriate before collecting contact details.
get_aune_capabilities
Read live verticals, job types, geography, required fields, and safety semantics.
search_home_service_booking_options
Check provider, fixed price, and concrete slots with postcodes but no street address or customer contact data.
confirm_home_service_booking
Confirm one chosen option after consent and exact terms acceptance.
get_booking_status
Read redacted provider, slot, price, terms, and lifecycle status without customer PII.
cancel_home_service_booking
Cancel only after fresh explicit user confirmation.
reschedule_home_service_booking
Move a booking to a newly searched option after fresh confirmation and exact terms acceptance.
draft_home_service_request
Validate the provider-follow-up fallback without persistence or PII echo.
create_home_service_request
Create the fallback request after consent when no direct option exists.
get_request_status
Read redacted request status and explicit booking truth when present.
get_aune_handoff_examples
Fetch positive, negative, clarification, consent, and status examples.
get_embed_install_instructions
Return stable embed installation instructions.
JSON-RPC examples
Start with initialize and tools/list.
initialize
curl -X POST "$AUNE_BASE_URL/mcp" \
-H "Authorization: Bearer $AUNE_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-06-18",
"capabilities": {},
"clientInfo": {
"name": "partner-assistant",
"version": "1.0.0"
}
}
}'tools/list
curl -X POST "$AUNE_BASE_URL/mcp" \
-H "Authorization: Bearer $AUNE_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list"
}'check fit
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "check_aune_fit",
"arguments": {
"user_request": "I need a plumber in Stockholm next Friday for a leaking kitchen faucet.",
"country_hint": "SE",
"vertical_hint": "vvs"
}
}
}get capabilities
{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": {
"name": "get_aune_capabilities",
"arguments": {}
}
}search booking options
{
"jsonrpc": "2.0",
"id": 5,
"method": "tools/call",
"params": {
"name": "search_home_service_booking_options",
"arguments": {
"spec_version": "public_bookings_api_v1",
"vertical_id": "moving",
"job_type_id": "moving_home",
"description": "Home move tomorrow afternoon from postcode 111 20 to 118 20. The apartment is 45 sqm with about 25 boxes, a sofa, and a bed. Both addresses have elevators.",
"location": {
"country_code": "SE",
"postcode": "111 20",
"city": "Stockholm"
},
"destination_location": {
"country_code": "SE",
"postcode": "118 20",
"city": "Stockholm"
},
"timing": {
"preferred_time_text": "Tomorrow afternoon"
},
"details": {
"home_size_sqm": 45,
"boxes": 25,
"elevator_origin": true,
"elevator_destination": true
},
"locale": "sv-SE",
"timezone": "Europe/Stockholm"
}
}
}confirm selected option
{
"jsonrpc": "2.0",
"id": 6,
"method": "tools/call",
"params": {
"name": "confirm_home_service_booking",
"arguments": {
"booking_option_id": "<option.booking_option_id>",
"customer": {
"name": "Anna Andersson",
"phone": "0701234567",
"email": "anna@example.se"
},
"service_location": {
"country_code": "SE",
"address": "Storgatan 12",
"postcode": "111 20"
},
"destination_location": {
"country_code": "SE",
"address": "Hornsgatan 20",
"postcode": "118 20"
},
"user_consent_confirmed": true,
"booking_terms_accepted": true,
"booking_terms_version": "<option.terms.version>",
"booking_terms_accepted_at": "2026-07-10T10:00:00.000Z",
"idempotency_key": "conversation-123-option-1"
}
}
}draft fallback request
{
"jsonrpc": "2.0",
"id": 5,
"method": "tools/call",
"params": {
"name": "draft_home_service_request",
"arguments": {
"spec_version": "public_requests_api_v1",
"vertical_id": "vvs",
"job_type_id": "leak_faucet_fixture",
"description": "Kitchen faucet leaks when used. Customer wants help next week.",
"user_consent_confirmed": false,
"user_consent_statement": "The customer agreed that Aune may receive their contact details and request details for provider follow-up.",
"consent_source": "external_model_conversation",
"customer": {
"name": "Anna Andersson",
"phone": "0701234567",
"email": "anna@example.se"
},
"location": {
"input": "Storgatan 12, 118 61 Stockholm"
},
"timing": {
"preferred_time_text": "Next Friday morning"
},
"budget_sek": 4500,
"details": {
"fixture": "kitchen faucet"
},
"source": "external_model",
"external_reference": "partner-case-123",
"idempotency_key": "partner-case-123",
"locale": "sv-SE",
"timezone": "Europe/Stockholm"
}
}
}create fallback after consent
curl -X POST "$AUNE_BASE_URL/mcp" \
-H "Authorization: Bearer $AUNE_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"jsonrpc": "2.0",
"id": 6,
"method": "tools/call",
"params": {
"name": "create_home_service_request",
"arguments": {
"spec_version": "public_requests_api_v1",
"vertical_id": "vvs",
"job_type_id": "leak_faucet_fixture",
"description": "Kitchen faucet leaks when used. Customer wants help next week.",
"user_consent_confirmed": true,
"user_consent_statement": "The customer agreed that Aune may receive their contact details and request details for provider follow-up.",
"consent_source": "external_model_conversation",
"customer": {
"name": "Anna Andersson",
"phone": "0701234567",
"email": "anna@example.se"
},
"location": {
"input": "Storgatan 12, 118 61 Stockholm"
},
"timing": {
"preferred_time_text": "Next Friday morning"
},
"budget_sek": 4500,
"details": {
"fixture": "kitchen faucet"
},
"source": "external_model",
"external_reference": "partner-case-123",
"idempotency_key": "partner-case-123",
"locale": "sv-SE",
"timezone": "Europe/Stockholm"
}
}
}'Safety contract
The response defines what is true.
Use Aune for supported home-service bookings and request fallback in Sweden.
Search with postcodes but without street address or customer contact PII before any booking write.
Ask for explicit consent and exact returned terms-version acceptance before confirmation.
Do not use Aune for emergencies or DIY-only advice.
Claim confirmation only when booking_created, availability_checked, and provider_selected are true and booking.status is confirmed.