Find local services, check live availability, and book real appointments with consent.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Create a REAL appointment. CONSEQUENCEFUL: only after the user has explicitly chosen a slot and authorized the booking in their own words. Flow: (1) check the service's bookingRequirements and collect any required customer details (e.g. phone); (2) create a mandate via the create_mandate tool with the user's exact instruction; (3) call this tool with the mandateRef. The mandate is single-use and expires in 15 minutes. On SLOT_NO_LONGER_AVAILABLE offer the returned alternatives — never rebook unilaterally.
From create_mandate (or create_mandate_for_draft) — records the user's authorization
Slot id from get_availability (preferred)
Booking draft the user consented to (from prepare_booking). When given, the request must match the draft exactly or booking fails with CONSENT_DRAFT_MISMATCH.
Stable key; safe retries return the original booking
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Create a REAL appointment. CONSEQUENCEFUL: only after the user has explicitly chosen a slot and authorized the booking in their own words. Flow: (1) check the service's bookingRequirements and collect any required customer details (e.g. phone); (2) create a mandate via the create_mandate tool with the user's exact instruction; (3) call this tool with the mandateRef. The mandate is single-use and expires in 15 minutes. On SLOT_NO_LONGER_AVAILABLE offer the returned alternatives — never rebook unilaterally.
| Argument | Type | Description |
|---|---|---|
| slot | object | |
| slotId | string | Slot id from get_availability (preferred) |
| draftId | string | Booking draft the user consented to (from prepare_booking). When given, the request must match the draft exactly or booking fails with CONSENT_DRAFT_MISMATCH. |
| customer* | object | |
| serviceId* | string | |
| businessId* | string | |
| mandateRef* | string | From create_mandate (or create_mandate_for_draft) — records the user's authorization |
| idempotencyKey | string | Stable key; safe retries return the original booking |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"businessId",
"serviceId",
"customer",
"mandateRef"
],
"properties": {
"slot": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string"
},
"start": {
"type": "string"
},
"staffId": {
"type": "string"
}
},
"additionalProperties": false
},
"slotId": {
"type": "string",
"description": "Slot id from get_availability (preferred)"
},
"draftId": {
"type": "string",
"description": "Booking draft the user consented to (from prepare_booking). When given, the request must match the draft exactly or booking fails with CONSENT_DRAFT_MISMATCH."
},
"customer": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string",
"description": "Required when the service's bookingRequirements.phone is 'required'"
},
"timezone": {
"type": "string"
}
},
"additionalProperties": false
},
"serviceId": {
"type": "string"
},
"businessId": {
"type": "string"
},
"mandateRef": {
"type": "string",
"description": "From create_mandate (or create_mandate_for_draft) — records the user's authorization"
},
"idempotencyKey": {
"type": "string",
"description": "Stable key; safe retries return the original booking"
}
},
"additionalProperties": false
}Legacy: record the user's authorization WITHOUT a booking draft. Prefer the draft flow: prepare_booking → show proposal → user agrees → create_mandate_for_draft → create_booking with draftId. The draft flow binds consent to the exact appointment the user saw.
| Argument | Type | Description |
|---|---|---|
| action* | string | |
| actorRef* | string | Your agent/session identifier, recorded in the audit trail |
| serviceId | string | |
| businessId* | string | Bind the mandate to this business |
| instruction* | string | The user's exact words — never fabricate or paraphrase |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"actorRef",
"action",
"businessId",
"instruction"
],
"properties": {
"action": {
"enum": [
"create_booking",
"reschedule_booking",
"cancel_booking"
],
"type": "string"
},
"actorRef": {
"type": "string",
"description": "Your agent/session identifier, recorded in the audit trail"
},
"serviceId": {
"type": "string"
},
"businessId": {
"type": "string",
"description": "Bind the mandate to this business"
},
"instruction": {
"type": "string",
"description": "The user's exact words — never fabricate or paraphrase"
}
},
"additionalProperties": false
}After the user explicitly agrees to the exact proposal in the draft (an affirmative reply such as 'yes, book it' — the user having already seen business, service, date and time), assert consent here to get a single-use mandate bound to that draft. consentObtained must be true; this assertion is audited. If anything consequential changes (different time, service or business), prepare a NEW draft and get fresh consent.
| Argument | Type | Description |
|---|---|---|
| consent* | object | |
| draftId* | string | The draft the user consented to (from prepare_booking) |
| actorRef* | string | Your agent/session identifier, recorded in the audit trail |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"actorRef",
"draftId",
"consent"
],
"properties": {
"consent": {
"type": "object",
"required": [
"consentObtained",
"draftId"
],
"properties": {
"draftId": {
"type": "string"
},
"consentedBy": {
"type": "string",
"description": "Who consented, e.g. 'the customer'"
},
"instruction": {
"type": "string",
"description": "The user's exact consenting words, for the audit trail"
},
"consentMethod": {
"type": "string",
"description": "How, e.g. 'chat reply: yes, book it' or 'spoken yes'"
},
"consentObtained": {
"type": "boolean",
"const": true
}
},
"additionalProperties": false
},
"draftId": {
"type": "string",
"description": "The draft the user consented to (from prepare_booking)"
},
"actorRef": {
"type": "string",
"description": "Your agent/session identifier, recorded in the audit trail"
}
},
"additionalProperties": false
}Search the AgentBookable registry for businesses that accept AI bookings. Search by free text, category, city, service name or geo radius. ALWAYS start here — the results include capability flags and _links telling you the exact next endpoints.
| Argument | Type | Description |
|---|---|---|
| city | string | e.g. 'Civray' |
| query | string | Free text on name/category/description/services, e.g. 'hairdresser' |
| service | string | Service name, e.g. 'Haircut' |
| category | string | |
| latitude | number | |
| radiusKm | number | |
| longitude | number |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"city": {
"type": "string",
"description": "e.g. 'Civray'"
},
"query": {
"type": "string",
"description": "Free text on name/category/description/services, e.g. 'hairdresser'"
},
"service": {
"type": "string",
"description": "Service name, e.g. 'Haircut'"
},
"category": {
"type": "string"
},
"latitude": {
"type": "number"
},
"radiusKm": {
"type": "number"
},
"longitude": {
"type": "number"
}
},
"additionalProperties": false
}Find LIVE availability for a service. Always call this immediately before create_booking — slots are temporary (~60s) and revalidated at booking. Pass an ISO-8601 window; use a slot id from the result when booking.
| Argument | Type | Description |
|---|---|---|
| to* | string | ISO-8601 window end |
| from* | string | ISO-8601 window start, e.g. 2026-09-01T00:00:00Z |
| serviceId* | string | |
| businessId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"businessId",
"serviceId",
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"description": "ISO-8601 window end"
},
"from": {
"type": "string",
"description": "ISO-8601 window start, e.g. 2026-09-01T00:00:00Z"
},
"serviceId": {
"type": "string"
},
"businessId": {
"type": "string"
}
},
"additionalProperties": false
}Retrieve a booking by its AgentBookable id (bb_bkg_*). Requires the mandateRef issued for that booking (from create_booking / create_mandate). Provider identity is never returned.
| Argument | Type | Description |
|---|---|---|
| bookingId* | string | |
| mandateRef* | string | Mandate ref returned when the booking was authorized/created |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"bookingId",
"mandateRef"
],
"properties": {
"bookingId": {
"type": "string"
},
"mandateRef": {
"type": "string",
"description": "Mandate ref returned when the booking was authorized/created"
}
},
"additionalProperties": false
}Get one business's record by id (ab_bus_*) or slug. Includes capabilities (availability/booking/reschedule/cancellation/payment) — NEVER promise an action whose flag is false — plus _links to the service list, availability endpoint and booking flow, and per-service bookingRequirements (e.g. whether customer phone is required).
| Argument | Type | Description |
|---|---|---|
| businessId* | string | ab_bus_* id or public slug, e.g. 'agentbookable-demo' |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"businessId"
],
"properties": {
"businessId": {
"type": "string",
"description": "ab_bus_* id or public slug, e.g. 'agentbookable-demo'"
}
},
"additionalProperties": false
}List the services a business has opened to AI booking. Each service has a durationMinutes and bookingRequirements telling you what customer details to collect (name/email/phone) BEFORE booking.
| Argument | Type | Description |
|---|---|---|
| businessId* | string | ab_bus_* id or slug |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"businessId"
],
"properties": {
"businessId": {
"type": "string",
"description": "ab_bus_* id or slug"
}
},
"additionalProperties": false
}Prepare a booking draft: the concrete proposal (business, service, time, customer) to show the user. Validates live availability and customer requirements — if requirements are missing you get MISSING_CUSTOMER_REQUIREMENT: ask the user for those details first, then call again. Show the returned draft to the user as the final proposal (business, service, duration, date/time), then obtain explicit affirmative consent. The draft expires after 30 minutes; consent binds to this exact proposal.
| Argument | Type | Description |
|---|---|---|
| slot | object | |
| slotId | string | Slot id from get_availability (preferred) |
| actorRef* | string | Your agent/session identifier for the audit trail |
| customer* | object | |
| serviceId* | string | |
| businessId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"businessId",
"serviceId",
"customer",
"actorRef"
],
"properties": {
"slot": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string"
},
"start": {
"type": "string"
},
"staffId": {
"type": "string"
}
},
"additionalProperties": false
},
"slotId": {
"type": "string",
"description": "Slot id from get_availability (preferred)"
},
"actorRef": {
"type": "string",
"description": "Your agent/session identifier for the audit trail"
},
"customer": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"timezone": {
"type": "string"
}
},
"additionalProperties": false
},
"serviceId": {
"type": "string"
},
"businessId": {
"type": "string"
}
},
"additionalProperties": false
}