AgentBookable

com.agentbookablePublished by agentbookable.comOfficial publisherv3.0.0Updated Oct 27, 2026

Find local services, check live availability, and book real appointments with consent.

VerifiedStreamable HTTPWeb executableLocation & LifestyleProductivity & Workflow

Overview

AI-generated overview

Lets an assistant search a registry of businesses open to AI bookings, check live availability, and create real appointments with recorded user consent.

What you can do
  • Search businesses by text, category, city, service or geo radius, and read a business record with its capability flags and links
  • List a business's bookable services, durations and the customer details each requires
  • Check live availability for a service within an ISO-8601 time window
  • Prepare a booking draft and validate it against live availability and customer requirements
  • Record user consent as a single-use mandate bound to the exact draft the user saw
  • Create a real appointment and retrieve it later by its booking id and mandate reference
When to use it
Useful when a user wants to find a local service provider and book an appointment through the assistant, with availability checked live and consent captured before anything is confirmed. Not needed for read-only research where no booking is intended.
Requirements
A remote streamable HTTP endpoint at agentbookable.com; no packages, environment variables or headers are declared. The assistant must collect any customer details a service requires (for example name, email or phone) before booking.
Before you install
create_booking creates a real appointment, so it should only follow an explicit user choice of slot and authorization in their own words. Consent is asserted through create_mandate_for_draft with consentObtained set to true and is audited. Availability slots are temporary (about 60 seconds) and revalidated at booking. Customer details such as name, email and phone are sent to the booking provider, and payment capability may be involved depending on the business.

Installation

In SourceWeft

  1. Open AgentBookable in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.agentbookable%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "agentbookable": {
      "type": "http",
      "url": "https://agentbookable.com/mcp"
    }
  }
}

Tools

9

find_businesses

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.

ParameterscityqueryservicecategorylatituderadiusKmlongitude

get_business

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).

ParametersbusinessIdrequired

list_services

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.

ParametersbusinessIdrequired

get_availability

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.

ParameterstorequiredfromrequiredserviceIdrequiredbusinessIdrequired

create_booking

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.

ParametersslotslotIddraftIdcustomerrequiredserviceIdrequiredbusinessIdrequiredmandateRefrequiredidempotencyKey

prepare_booking

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.

ParametersslotslotIdactorRefrequiredcustomerrequiredserviceIdrequiredbusinessIdrequired

create_mandate_for_draft

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.

ParametersconsentrequireddraftIdrequiredactorRefrequired

get_booking

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.

ParametersbookingIdrequiredmandateRefrequired

create_mandate

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.

ParametersactionrequiredactorRefrequiredserviceIdbusinessIdrequiredinstructionrequired

Version history

1
  1. v3.0.0LatestSep 16, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.